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PREFACE 


This manual is intended for the person who is charged with 
configuring the GCOS 6 MOD 400 system software to meet the char- 
acteristics and requirements of his installation site. This 
person iS assumed to be well acquainted with the GCOS 6 MOD 400 
Executive and with Honeywell's Series 60 (Level 6) minicomputer 
systems. In addition, this person is assumed to have read the 
System Concepts manual, and if he intends to build a system sup- 
porting communications devices, the Communications Processing 
manual. The Manual Directory at the beginning of this manual 
lists the titles and order numbers of pertinent documents. 


This publication describes in detail the procedures necessary 
to build the system, the system building directives from which 
the MOD 400 Executive is assembled, and the utility programs used 
in the building process. : 


Section 1 of this manual introduces the subject of system 
building and briefly describes the contents of the document. 


Section 2 outlines information the system builder must gather 
prior to configuring a system to his specifications. 


Section 3 describes the three stages of system Startup and 
the purpose of each stage. Section 3 also describes the opera- 
tor's and the system's actions during system startup. 


Section 4 describes how to use the interactive CLM directive 
generation program, M4 SYSDEF. 


The information and specifications in this document are subject 
to change without notice. This document contains information 
about Honeywell products or services that may not be available 
outside the United States. Consult your Honeywell Marketing 
Representative. 
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section 5 describes in detail the noncommunications direc- 
tives that are processed by the Configuration Load Manager -- a 
system software tool -- as it configures the system to stipulated 
Specifications. 


section 6 describes communications-related directives pro- 
cessed by the Configuration Load Manager. 


section 7 lists the contents of the system disks on which 
GCOS 6 MOD 400 and other related software components are 
available. 


Section 8 includes a number of miscellaneous but important 
technical notes, most of which pertain only to certain installa- 
tion sites. This section should be read before attempting to use 
the system. 


Appendix A presents an overview of the various types of halts 
possible during system startup. 


Appendix B lists the names and approximate sizes of all sys- 
tem overlays, which may be used as overlays or, where optimum 
speed is deSired for the related function, selectively made per- 
manently resident in memory. 


Appendix C contains minimum system guidelines and a list of 
Supported equipment. 


Appendix D describes configuration considerations relative to 
the Power Resumption facility. 


Appendix E deals with configuration information (including 
linking) pertaining to the Data Entry Facility. 


Appendix F describes configuration information for the Remote 
Batch Facility. 


Appendix G presents configuration information relative to the 
file transmission capability. 


Appendix H and Appendix J provide configuration information 
pertaining to IBM Workstation Facilities. 


Appendix K presents configuration information for the 
Programmable Facility/3271. 


Appendix L describes installation and activation of the 
Listener and Login capability. 


Appendix M provides a handy checklist for use with the 
M4 SYSDEF interactive CLM directive generation program. 
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Appendix N provides configuration information for the error 
logging capability. | | - 


Appendix P provides configuration information for the Display 
Formatting and Control software. 


After reading this manual, the usSer should be able to build 
the system for initial operation and onsite personnel training, 
and rebuild the system later on, if necessary, to satisfy the 
installation's changing needs. 


The examples presented in this publication are for illustra- 
tive purposes only; they are not intended for execution. 


For the sake of clarity in examples, user typeins (commands 
and directives) are distinguished from system typeouts 
(responses) by arrows, as shown: 


=> COMMAND LINE 
SYSTEM RESPONSE 


The following conventions are uSed to indicate the relative 
levels of topic headings used in this manual: 


Level 1 (highest) ALL CAPITALS, UNDERLINED 

Level 2 Initial Capitals, Underlined 
Level 3 ALL CAPITALS, NOT UNDERLINED 
Level 4 Initial Capitals, Not Underlined 


Symbols used in this manual are described below: 
e Brackets [] indicate an optional directive entry. 


e Braces {} enclose information from which a choice must be 
made. 


e The character A indicates a space. 
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SUBJECT DIRECTORY 


This subject directory can help you find information about 
Specific topics related to GCOS 6 MOD 400. ‘Topics are listed 
alphabetically; each topic is accompanied by the base publica- 
tion number of the manual(s) in which the topic is described. 
All GCOS 6 MOD 400 manuals are listed at the end Of the subject 
directory. 
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MANUAL DIRECTORY 
The following publications constitute the GCOS 6 MOD 400 
manual set. See the “Manual Directory" of the MOD 400 Software 
and Documentation Directory for the revision number and addenda 
(1f any) of release-specific editions. 
Manuals are obtained by submitting a Honeywell Publications 
Order Form to the following address: 
Honeywell Information Systems Inc. 
47 Harvard Street 
Westwood, MA 02090 
ATTN: Publications Services 
Honeywell software reference manuals are periodically updated 
to support enhancements and improvements to the software. Before 


ordering any manual listed below, the customer should refer to 
the MOD 400 Software and Documentation Directory to obtain ed 
information concerning the specific edition of the manual that 

Supports the software currently in use at the installation. When 
Specifying manuals on the Publications Order Form, a customer 

uSing the 4-digit base publication number listed below will 

obtain the latest edition of the manual currently in stock. The 
Publications Distribution Center can provide specific editions of 
publications only when supplied with the 7- or 8-character order 


number described in the Software and Documentation Directory. 


Honeywell applications software packages - such as INFO 6, 
TOTAL 6, and TPS © —- provide specialized services. See your 
Honeywell representative for information concerning the avail- 
ability of applications software and supporting documentation. 
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In addition, the following publications provide supplementary 


information: 
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AT97 Level 6 Communications Handbook 


CC71 Level 6 Minicomputer Handbook oof 
CD18 Level 6 MOD 400/600 Online T&V Operator's Guide 4 
FQ41 Writable Control Store User's Guide Se? 


Additionally, the user should be aware that a software 
release bulletin accompanies each Software product item ordered 
from Honeywell. The user should consult the software release 
bulletin before uSing the software. See your Honeywell represen- 
tative if a copy of the software release bulletin is not 
available. 
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SECTION 1 


SYSTEM BUILDING OVERVIEW 


system building consists of several discrete operations, each 
described in different sections of thiS manual. The purpose of 
this section is to place these operations into perspective, and 
to enable you to obtain a general view of the system building 
process. 


Honeywell delivers a disk volume containing the software you 
ordered plus an operating MOD 400 Executive. System building 
consists of specifying your system variables, identifying your 
peripheral devices and (optional) communications environment and 
talloring main memory to suit system and uSer needs. A "system 
build," starting with the initially Supplied system, consists of 
the operations described below. 


PRELIMINARY CONSIDERATIONS 


Before starting to build your system, you must take stock of 
the hardware in your configuration. You must be familiar with 
the characteristics of each peripheral and (optional) communica- 
tions device. You must also be aware of what software packages 
you wish to build into your system, consulting the appropriate 
software manuals as necesSary. These preliminary considerations 
are discussed in more detail in Section 2. 


INITIAL SYSTEM STARTUP 


system building iS a progressive process and is typically 
performed in three discrete stages, each of which is initiated by 
an appropriate type of system startup. To build your new MOD 400 
system, you must first start up the initially Supplied system on 
your hardware configuration. The system is deSigned to start up 
without difficulties on most hardware configurations. 


The three stages of system startup, and the purpose of each 
stage, are described in Section 3. Each stage of system startup 
involves (1) bootStrapping the system from disk into main memory, 
(2) execution of the Configuration Load Manager (CLM) which reads 
a file of CLM directives and causes the system to be configured 
accordingly, and (3) creation of a system task group. As 
described in Section 3, additional actions are possible at system 
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startup, depending on whether a special file (named START UP.EC) 
exists in the initial working directory of the system task group. a 


SYSTEM BUILDING 


System building consists of creating a file containing a 
series of system building directives which completely specify the 
Characteristics of the system. These characteristics include the 
hardware options and physical memory present in the central pro- 
cessor, the complement of peripheral and communications devices 
present in your configuration, and the manner in which memory is 
to be allocated among sysStem and application tasks. (The system 
building directives are described in detail in Sections 5 and 6). 


You create this directive file on disk, uSing either an 
interactive building program or the standard text editor. Once 
created, the file contains configuration directives, which when 
executed, will configure a system that corresponds to the actual 
installation hardware. 


HOW TO USE THIS MANUAL 


sections 1, 2, and 3 should be read carefully before you 
begin system building procedures. Sections 1 and 2 provide a 
general description of system building and outline the informa- 
tion a first-time user needs to know before building a special- 
ized system. Section 3 describes the three stages of system 
startup that must be followed to create an operating environment. 
An interactive CLM directive generation program, called 
M4 SYSDEF, is provided for your convenience in creating the CLM 
directive file, and is fully described in Section 4. Using 
M4 SYSDEF according to directions will result in a syntactically 
correct file of CLM directives. 


Non-communications CLM directives and communications CLM 
directives, used to specify the system configuration, are 
described in detail in Sections 5 and 6, reSpectively. Refer to 
these sections when creating or modifying your specialized CLM 
directive file. If your system Supports communications devices, 
you Should be familiar with the Communications Processing manual. 


Section 7 describes the contents of the system release media. 
Typically, an installation will receive all of its system soft- 
ware (including any separately priced "extensions* that have been 
ordered) on one type of release medium; that 1S, on one or two 
cartridge disks, on one mass storage unit (also called a "Storage 


module"), on one cartridge module disk, or On multiple diskettes. 


Section 8 comprises a number of miscellaneous technical 
notes, most of which pertain only to certain installation Sites. 
It is important that each prospective system builder familiarize 
himself with the contents of Section 8 and ascertain which of its 
topics apply to his installation, before he attempts to use the Ko 
system. 


i : | CB23-03 


ile i, 


Most of the appendices in this manual also describe subjects 
of interest. only to certain installation sites. Among these sub- 
jects are configuration information regarding the Data Entry 
Facility-I (DEF-I), the Remote Batch Facility (RBF), and file 
transmission. 


Appendixes H, J, and K present configuration information for 
the IBM Workstation Facilities and the Programmable Facility/ 
3271. Appendix L describes Listener and Login capabilities. 


An M4 SYSDEF checklist is supplied for your convenience in 
Appendix M. Use this list as a guide when defining your system's 
resources prior to invoking the M4 SYSDEF program. 


Appendix N describes how to configure the error logging 
capability so your installation can monitof memory and device 
performance. 


Appdendix P describes configuration procedures for the Dis- 
play Formatting and Control software. This software provides the 
forms processing capability for your installation. 


In general, this manual does not include conceptual informa- 
tion; instead, where necessary, see the System Concepts manual 
and/or a manual specific to the desired subject area. Commands 
mentioned in this manual are described in the Commands manual. 
Those operator commands that are not available to the general 
user community, for example the CSD (change system directory) 
Operator command, are described in the Operator's Guide. System 
macro calls are described in the System Service Macro Calls 


manual. 


L3 CB23-03 


SECTION 2 


PRELIMINARY CONSIDERATIONS 


Before you actually begin to build your system, you should 
first compile the information you'll need to configure the system 
to your specifications. The categories of information required 
are broken into hardware, software, and communications considera- 
tions and are discussed further below. Figure 2-1 is a flowchart 
of the recommended procedure for gathering information. 
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START 
LIST 
HARDWARE 
CHARACTERISTICS 
LIST 
SOFTWARE 
CHARACTERISTICS 
LIST 
YES |COMMUNICATIONS 
COMMUNICATIONS CHARACTERISTICS 
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OEFAULT NO NAMING 
SPD NAMES > SCHEME 
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LIST 
DEFAULT NO CHANNEL 
CHANNELS NUMBER 
OK SCHEME 
YES 
STOP 
Figure 2-1. Preliminary Considerations Flowchart ae 
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HARDWARE CHARACTERISTICS 


You must have available the hardware characteristics of the 
devices in your configuration. You can obtain this information 
by consulting the appropriate hardware reference manuals as 
necesSary. 


Specifically, for the central processor, you must know: 
e The model number 
e Whether the central processor iS a commercial model 


@ Whether the central processor includes the Scientific 
Instruction Processor 


e The size of main memory 


@e The number of multiline/dual-line communications 
processors (MLCPS/DLCPs) 


e If an MMU is included 
For peripheral devices, you must know: 


e The maximum number of devices that you want to configure 
(regardless of how many are on the bus) 


e How many of each type of peripheral device you have in 
your configuration, identified by marketing identifier 
(see Appendix C) 


e For terminals, you must know the transmission modes, l-ine 
Speeds, desired I/O characteristics, and modem types 


e For disk devices, you must know whether each cartridge 
disk or cartridge module disk has a fixed and removable 
platter; you must also know the storage capacity of each 
device 


e For tape drives, you must know the recording density and 
number of tracks 


SOFTWARE CHARACTERISTICS 


Once you have compiled a list of hardware characteristics, 
you Should proceed to gather information on the software char- 
acteristics of your configuration. You must determine what soft- 
ware subsystems your installation will use. Equipment require- 
ments and characteristics of individual software packages are 
available in the appropriate software reference manuals. 
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Specifically, you must know: 


e The text strings you wish to use as the system and 
installation identification of your system 


e The anticipated maximum number of concurrent users 


e The largest logical file number and logical resource 
number available to users 


e The anticipated number of 512-word system overlay areas 


e Whether or not the system will include a batch memory 
pool (and its size) 


e Whether the system will include the commercial or scien- 
tific instruction simulators 


e Whether or not the system will incorporate record lock- 
ing or Display Formatting and Control software 


e A coherent aSSignment scheme for symbolic peripheral 
device names, channel numbers, communications priority 
levels, and logical resource numbers (see the System 
Concepts manual) 


e The number of communications line protocols (the recom- 
mended maximum iS two per MLCP/DLCP) 


COMMUNICATIONS CHARACTERISTICS 


If you intend to include communications devices in your 
configuration, you must read the Communications Processing 


manual first, and be thoroughly familiar with the hardware and 


software characteristics of your communications devices. 
Specifically, you must know: 
e Which protocols you need 
e For polled VIP devices (VIP7700 or VIP7804), a poll 


address scheme, device type, which stations are control/ 
tributary stations, and characteristics of any receive- 


only printers 


e For H3270 Host Links, a poll address scheme, a select 
address scheme, and a communications priority level for 
each line 


e A priority level sharing scheme 


e The number of channel control programs per MLCP/DLCP 
(the recommended maximum is two) 
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e For asynchronous terminals, the communications priority 
level and device type for each 


e For BSC lines, the communications priority level and the 
number of primary and/or secondary lines 


e For ACU channels, the Irn of the station associated with 
each ACU and the list of telephone numbers asSociated with 
each data communications channel 


e For stations driven by a uSer-written line protocal 
handler, whether the line is full- or half-duplex, and the 
lph-specific word for each station 


e For teleprinter compatible devices, the communications 
priority level and modem type for each device 


e Which communications stations will be accessible through 
the file system 


e The polling scheme on a line serviced by the synchronous 
terminal driver line protocol handler 


e For polled or nonpolled VIP terminals, the lrn, level, 
and channel 


e For IBM workstations on a line serviced by the HASP line 
protocol handler, the lrn, level, and channel 


e For stations on a line serviced by the Remote Computer 
Interface line protocol handler, the lrn, level, and 
channel. 


This is only meant to be a representative sampling of some of the 
software and hardware characteristics of which you must be aware. 
For a full description of each communications protocol, see 
Section 6. 
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SECTION 3 


SYSTEM STARTUP 


System startup consists of the following steps: 


1. The system is bootstrapped into main memory as the re- 
sult of a procedure performed at the central processor's 
control panel. 


2. The Configuration Load Manager (CLM), a system component, 
reads a file of CLM directives, which causes the system 
to be configured according to the contents of the 
directives. 


3. A system task group ($S) is created after system config- 
uration iS completed. If the initial working directory 
for the system task group contains a file named 
START UP.EC, the operator commands in that file are exe- 
cuted to further establish the environment that is 
desired at the end of system Startup. (For example, 
the START UP.EC file may contain operator commands that 
Spawn additional task groups.) 


Thus, system startup establishes an operating environment and 


brings the system to a "ready" state, at which point system oper- 
ations may begin. 
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There are three stages of system startup. 


1. Stage 1 Initial System Startup, which is performed at . | 
system installation.: This type of startup is used to ee 
establish a limited environment that will allow you to 
use the interactive CLM directive generation program 
M4 SYSDEF or the Editor to create your own file of CLM 
directives. During a stage 1 system startup, the Con- 
figuration Load Manager reads one of two supplied files 
of CLM directives that define a limited environment. 
The file of CLM directives read by the Configuration 
Load Manager depends on which of the following situa- 
tions exists at system startup: 


a. Bootstrap volume is a cartridge disk, cartridge 
module disk, diskette, or mass storage unit; one 
Or more terminalsS are connected to an MDC. 


b. Bootstrap volume is a cartridge disk, cartridge 
module disk, diskette, or maSs storage unit; no 
terminal is connected to an MDC, but one or more 
terminals are connected to an MLCP/DLCP. 


In a stage 1 system startup, the initial working direc- 
tory for the system task group is SID. This working 
directory contains a START UP.EC file that causes a 
second task group ($H) to be spawned.’ 


2. Stage 2 Intermediate System Startup. This stage of 
system startup is used after you have created your own 
file of CLM directives, i.e., a file named CLM USER 
(under SID), which describes your own installed hard- 
ware configuration and other details of the environment 
you wish to use for application development. (You will 
have created CLM USER by using M4 SYSDEF or the Editor 
in the limited environment established as the result of 
a stage 1 system startup.) 


In a stage 2 system startup, your tallored CLM USER 
file must exist under directory SID on the bootstrap 
volume. The Configuration Load Manager will read this 
file instead of the one selected during a stage 1 
system startup. 


1A Stage I system startup can also be used at a later time, in 
the event that an error in a user-created file of CLM directives 
prevents a successful stage 2 or stage 3 system startup. See 
"Bootstrap Options" later in this section. 


*>SID>START UP.EC is reserved for use during a stage 1 system aa 
Startup. 
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In a stage 2 system startup, the initial working direc- 
tory for the system task group is the root directory of 
the bootstrap disk. This working directory contains a 
START UP.EC file that causes a second task group (SH) 
to be spawned. 


Following a stage 2 system startup, application develop- 
ment can proceed in an environment you have defined to 
match your own reSources and needs. When you have 
reached a point where you wish to define a fully spec- 
lalized system refined to precisely match your require- 
ments for a standard operating environment, you can use 
the M4 SYSDEF program in Rebuild mode or the Editor to 
modify the contents of CLM USER so that they describe 
your final system. In addition, you can modify (or 
delete) the START UP.EC file of operator commands imme- 
diately subrodinate to the root directory of the boot- 
strap volume. Note that "refining" takes place over a 
period of time, aS you gain experience with the system. 


3. Stage 3 Fully Specialized System Startup. This stage 
of system startup iS used after you have made final ad- 
justments to the CLM directives in the CLM USER file and 
any necessary modifications to the START UP.EC file. 
This stage of system startup is used to achieve your 
final configuration, one that reflects your total hard- 
ware environment, optimized use of central processor 
main memory, and all other characteristics of your 
standard system. 


Once a satisfactory CLM USER file and START UP.EC file 
(if any) have been established, this type of system 
Startup can be performed routinely, even by noncomputer 
personnel. 


Figure 3-1 Summarizes the three stages of system startup. 


STAGE 1 INITIAL SYSTEM STARTUP WHEN PERFORMED 

ONE OF TWO HONEYWELL-SUPPLIED ONCE AT SYSTEM INSTALLATION. 
FILES OF CLM DIRECTIVES IS USED THEREAFTER, IF NECESSARY, TO 
TO DEFINE A LIMITED ENVIRONMENT PERMIT CORRECTION OF ERRORS IN 
IN WHICH M4 SYSDEF OR THE EDITOR USER-CREATED FILE OF CLM 

CAN BE RUN TO CREATE AN DIRECTIVES « 


INSTALLATION-SPECIFIC FILE OF 
CLM DIRECTIVES. 


(>SID>START UP.EC FILE IS EXE- 
CUTED FOLLOWING CONFIGURATION.) 


Figure 3-1. Stages of System Startup 
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STAGE 2 INTERMEDIATE SYSTEM WHEN PERFORMED 


STARTUP 
USER-CREATED FILE OF CLM ONCE AT SYSTEM INSTALLATION, 
DIRECTIVES, CLM USER, IS USED AFTER CREATION OF CLM USER 
TO DEFINE AN ENVIRONMENT IN FOLLOWING A STAGE 1 SYSTEM 
WHICH APPLICATION DEVELOPMENT STARTUP. THEREAFTER, AS 
CAN BE PERFORMED. (“ROOT NECESSARY. 


DIRECTORY>START UP.EC FILE IS 
EXECUTED FOLLOWING 
CONFIGURATION. ) 


STAGE 3 FULLY SPECIALIZED 
SYSTEM STARTUP 


FULLY SPECIALIZED FILE OF CLM WHEN STANDARD SYSTEM OPERA- 
DIRECTIVES (ADJUSTED CLM USER) TIONS ARE FEASIBLE, AFTER 
IS USED TO DEFINE THE STANDARD NECESSARY APPLICATIONS HAVE 
ENVIRONMENT FOR FULL SYSTEM BEEN CREATED FOLLOWING A 
OPERATIONS. (IF PRESENT, STAGE 2 SYSTEM STARTUP. A 
“ROOT DIRECTORY>START UP.EC STAGE 3 SYSTEM STARTUP CAN BE 
FILE IS EXECUTED FOLLOWING PERFORMED ROUTINELY AFTER 
CONFIGURATION.) SATISFACTORY CLM USER HAS BEEN 
ESTABLISHED. — 


Figure 3-1 (cont). Stages of System Startup 
STAGE 1 SYSTEM STARTUP (INITIAL SYSTEM STARTUP) 


A stage 1 system startup causes the system to be boot- 
Strapped, the Configuration Load Manager to configure the system 
uSing an existing file of CLM directives, and the operator com- 
mands in the >SID>START UP.EC file to be executed. The result 
is a limited system environment that allows you to use the inter- 
active CLM directive generation program M4 SYSDEF or the Editor 
to create your own file of CLM directives. 


The environment achieved by a stage 1 system startup is as 
follows: 


e A removable cartridge disk, cartridge module disk, a mass 
storage unit, or a diskette (depending on the device from 
which the system was bootstrapped). 


@e Either an MDC-connected operator terminal or an MLCP/DLCP 
connected operator terminal. (The former is used, if 
present.) 


e One online memory pool and one online task group (SH), in 
addition to the system memory pool and system task group 


($S). 
A stage 1 system startup consists of the following steps: 
1. Set the central processor control panel POWER switch 


to ON and turn on the power for all devices. 
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Mount the volume containing the Honeywell-supplied 
system software on the bootstrap device (cartridge disk, 
Cartridge module disk, mass storage unit, or diskette). 


Perform the following bootstrap procedure at the central 
processor control panel: 


a. 


Press Stop. 
Press CLeaR. 
Press Load. 
Press Execute. 


Wait for the TRAFFIC light to turn off. (If the 
bootstrap channel is not 0400 and/or if any of the 
bootstrap options deScribed in Table 3-2 are to be 
used, see “Operator's Startup Actions," later in this 
section.) 


Press Ready 
Press Execute. 


The system is bootstrapped into main memory. Depend- 
ing on the terminal configuration, one of the two 
Supplied files of CLM directives under directory SID 
is read by the Configuraration Load Manager and the 
System is configured accordingly. 


(1) CLM MDC is used if the bootstrap volume is a 
cartridge disk, cartridge module disk, mass stor- 
age unit, or diskette; one or more terminals 
are connected to an MDC. 


(2) CLM MCP is used if the bootstrap volume is a 
Cartridge disk, cartridge module disk, mass stor- 
age unit, or diskette; one or more terminals 
are connected to an MLCP/DLCP. 


If your configuration includes both MDC- and MLCP/ 
DLCP connected terminals, the system uses CLM MDC. 


A system task group ($S) iS Spawned. The operator 
commands in >SID>START UP.EC are executed, and a user 
task group ($H) is spawned. 


If your configuration includes a terminal connected 
to an MDC, system startup is now complete. Other- 
wise, your configuration must include a terminal 
connected to an MLCP/DLCP and you must perform steps 
h, i, and j (full control panel required). 
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h. Wait for the TRAFFIC light to turn off. (If the 
terminal's line speed should be other than 0110 bits 
per second- the default value -enter the appropriate 
line speed in the Rl-register. See the paragraph 
below and Table 3-1.) 


i. Press Ready. 
j- Press Execute. 
The operator terminal is selected as follows: 


Le If there are one or more terminals connected to an 
MDC, the one with the lowest channel number is 
selected. 


2. If there are no terminals connected to an MDC, there 
must be one or more terminals connected to an MLCP/ 
DLCP. In this case, the MLCP/DLCP-connected terminal 
with the highest channel number is the operator 
terminal. | 


Since a communications terminal can run at different 
line speeds, you must determine the correct line 
speed of the terminal with the highest channel number 
and then, in the procedure described above, when the 
TRAFFIC light turns off in step 3h, you enter the 
correct line speed in the Rl-register. The default 
value is 0110 bits per second. 


Completion of system startup is signaled by the message shown 
in Figure 3-2. If your terminal is connected to an MDC, don't 
press any terminal keys until after the system startup message 
appears. If you do, you can recover by pressing the BREAK key. 


($SS)GCOS6 MOD400 - arrr —- mm/dd/hhnn 
(SH)$H Group ready! 


NOTE: See the accompanying text for an explanation 
of the variables in the first line. 


Figure 3-2. System Startup Typeout at Operator Terminal 


The system startup message, shown in Figure 3-2, is inter- 
preted as follows: 


e ($S)GCOS6 MOD400 - arrr - mm/dd/hhnn 


Indicates the completion of system startup. a is S for a 
SAF system, L for a LAF system. rrr indicates the release 
number of the system Executive. mm/dd/hhnn indicates the 
date/time when the Executive was linked (month, day, 
hours, minutes). 
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e (SH)SH Group ready! 


{ Indicates that a user task group, which has the command 

: processor as its lead task, is ready for the entry of com- 
mands. This task group has been spawned by a command in 
>SID>START UP.EC. The typeout is the result of a command 
in the supplied >HIS>START_UP.EC file. 


Table 3-1. TTY Terminal Line Speeds 


Type 2100, 2110, or 2118 
Type 2108 Communications-—Pac Communications-Pac 


Speed Speed 
(Entered in Rl-Register) (Entered in Rl-Register) 


NOTE: A speed of 0134 represents 134.5 bits/second. 


STAGE 2 SYSTEM STARTUP (INTERMEDIATE SYSTEM STARTUP) 


A stage 2 system startup can be performed only after you have 
created your own file of CLM directives, named CLM USER under 
directory SID on the bootstrap volume. The contents of CLM USER 
should describe the environment you wish to use for application 


development. 
Creating CLM-USER 


The recommended approach for creation of CLM USER is shown 
below. _ 


Me 
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1. Following a stage 1 system startup, invoke M4 SYSDEF to 
run under task group $H. Although you can create the “ 
CLM USER file directly by using the Editor, Honeywell . 
recommends that you use M4 SYSDEF, the interactive a 
system building program, even if you have built the 
system before. See Section 4 for a complete descrip- 
tion of how to use M4 SYSDEF. 


2. After creating a CLM USER file using M4 SYSDEF and 
placing it immediately subordinate to directory SID on 
your bootstrap volume, continue with the steps necessary 
for a stage 2 system startup. 


If you wish to create your own CLM USER file without uSing 
M4 SYSDEF, or if you wish to modify the existing CLM file to 
reflect changes in your installation's configuration, follow 
steps 1 through 7 below to use the Editor. 


USING THE EDITOR 


1. Following a stage 1 system startup, invoke the Editor to 
run under task group SH. 


You may be required to change the default task group of 
the operator's terminal from the SS (System) task group 
to the $H task group. Enter the following lines at the 
operator's terminal immediately following system startup: 


ACA:SH: (transfers default task group of the 
operator's terminal from $S to SH task 
group) 

RDN (The ready on (RDN) command causes a 


prompt message to appear at your 
terminal. This command is for con- 
venience only and is not required) 


If you have entered RDN, the system will respond with the 
prompt message: 


(SH)RDY: 


Note that no prompt message appears unless you speci- 
fied RDN. 


You are not ready to invoke the Editor, as described in 
the Commands manual and the Program Preparation manual. 


Sample Editor work sessions are provided in the 


Programmer's Guide. 


2. If you are modifying an existing CLM file, use the Edi- 
tor's read directive to read the file's contents into the 
Editor's "current buffer." If you are creating a CLM a 
file, go to step 5. | 
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Use the Editor's print directive to print out the entire 
contents of the current buffer. 


Inspect the printout and identify the differences between 
the contents of the current buffer and your desired file 
of CLM directives. 


Use the Editor's insert, change, append, and delete 
directives to modify the contents of the current buffer 
So aS to define the CLM directives that describe your 
application development configuration. 


Use the Editor's print directive to print out the entire 

contents of the current buffer. Ensure that the contents 
accurately reflect your desired CLM directives. (If any 

corrections are necessary, repeat steps 5 and 6.) 


Use the Editor's write directive to write the entire con- 
tents of the current buffer to >SID>CLM USER. (You may 
give your CLM file any name you wish, although it is 
recommended that you call it CLM USER. Note that the 
Configuration Load Manager must be able to locate a file 
named CLM _ USER at system startup. 


Stage 2 Startup 


Once you have defined the desired contents of >SID>CLM_USER, 
you can perform a stage 2 system startup by taking the following 


steps: 


1. 


Ze 


Ensure that the central processor control panel's POWER 
Switch is ON and turn on power to all equipment. 


Ensure that the volume containing the Honeywell-supplied 
system software is mounted on the bootstrap device. 


Perform the following bootstrap procedure at the central 
processor control panel: 


a. Press Stop. 
b. Press CLeaR. 
Wait for CHECK light to go out. 


Cus Press Load. 


ve Press Execute. 


e. Wait for the TRAFFIC light to turn off. (If the 
bootstrap channel is not 0400 and/or if any of the 
bootstrap options described in Table 3-2 are to be 
used, see "Operator's Startup Actions," later in this 
section.) 
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f. Press Ready. 


g- Press Execute. a 
The system is bootstrapped into main memory. The 
CLM USER file in directory SID is read by the Config- 
uration Load Manager and the system is configured 
accordingly. 


A system task group ($S) iS Spawned. The operator 

commands in the Honeywell-Supplied “root directory 

>START UP.EC file are executed, causing a user task 
group ($H) to be spawned. 


System startup is complete. The system startup message is 
issued at the operator terminal, which, in the case of a stage 2 
System startup, is the terminal associated with logical resource 
number (lrn) O in a CLM directive. (If the operator terminal is 
connected to an MLCP/DLCP, the terminal's line speed and other 
communications characteristics are defined in a CLM directive.) 


If a CLM directive in CLM USER contains an error caused by 
incorrect syntax or if the CLM directive is an invalid duplicate, 
an error message will appear at the operator terminal (if possi- 
ble). See "Configuration Load Manager Error Reporting" at the 
end of this section. If an uncorrectable error prevents success- 
ful completion of a stage 2 system startup, it is possible, by eke 
means of the appropriate bootsStrap option (See Table 3-2), to 
bypass the CLM USER file and perform a stage 1 system startup Sisal 
using one of the two supplied files of CLM directives. This 
technique allows you to re-establish a limited system configura- 
tion in which you can use the Editor or M4 SYSDEF to correct 
CLM USER before reattempting a stage 2 system startup. 


Note also that the supplied START UP.EC file directly sub- 
ordinate to the bootstrap volume's root directory is normally not 
modified prior to a stage 2 system startup. 


Once a satisfactory stage 2 system startup has been achieved, 
you can use the resulting system for application development or 
aS a means of gaining experience in the use of the system 
software. 


STAGE 3 SYSTEM STARTUP (FULLY-SPECIALIZED SYSTEM STARTUP) 


A stage 3 system startup is very similar to a stage 2 system 
Startup. The principal difference is that application develop- 
ment performed following a stage 2 system Startup provides you 
with information you may wish to use in refining the CLM direc- 
tives in your CLM USER file. For example, you may wish to change 
certain MEMPOOL directives and/or cause certain system overlays 
to be made permanently resident. Moreover, you may wish to 
describe additional peripheral devices that were not previously ( 
identified in CLM USER because they were not used during applica- UY 
tion development. | 
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Thus, prior to performing a stage 3 system startup, you will 
probably have used the Editor or M4 SYSDEF to update the contents 
of CLM USER. Additionally, you must decide whether to retain, 
modify, or delete the START UP.EC file immediately subordinate to 
the bootstrap volume's root directory (i.e., the START UP.EC file 
used in a stage 2 system startup). If you wish to retain this 
START UP.EC file in itsS original condition (but not use it during 
a stage 3 system startup), you may use the RENAME command. 


The steps performed in a stage 3 system startup are identical 
to those used for a stage 2 system Startup except that the 
“root director y>START UP.EC file may have been modified or 
deleted. If this file exists at the time of a stage 3 system 
Startup, all operator commands therein will be executed. 


SUMMARY OF STARTUP PROCEDURE 


The following paragraphs and Figure 3-3 Summarize the startup 
procedure. 


Every time the system is bootstrapped, a software component 
ascertains whether an initially-Supplied or a user-created file 
of CLM directives is to be read by the Configuration Load Man- 
ager. If an initially-Supplied file is used, a software algo- 
rithm also ascertains whether the operator terminal is to be an 
MDC-connected terminal or an MLCP/DLCP-connected terminal. If a 
user-created CLM file is used, a CLM directive dictates which 
device is to be the operator terminal. 


During a system startup in which an initially-supplied CLM 
file is used (1.e., a Stage 1 system Startup), operator commands 
in the START UP.EC file in directory >SID will be executed. Dur- 
ing a stage 2 system startup (user-created file of CLM directives 
used), operator commands in the supplied START UP.EC file under 
the bootstrap volume's root directory will be executed. During 
a Stage 3 system startup (refined user-created file of CLM 
directives used), operator commands in the START UP.EC file under 
the bootstrap volume's root directory will be executed if such a 
file is present either in its original form or aS modified by the 
user. 
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Figure 3-3. Flowchart of System Startup Process 
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AT COMPLETION OF 
CONFIGURATION, 
CREATE A SYSTEM 
GROUP USING A 
WORKING DIRECTORY 
OF ~ROOT>SiID 


SYSTEM GROUP 
STARTUP PHASE 
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Ree oP 
SYSTEM GROUP 
STARTUP 
SEARCH FOR “START__UP.EC"” 
IN THE WORKING DIRECTORY 
_~SYSTEM GROUP 
IS NOW READY 
EXECUTE IT (SAMPLE 
COMMANDS FOLLOW) 
COMMAND FILE 
PRINT: “SYSTEM 
GROUP STARTUP" 
SPAWN A "$H” Roe ai ich ag Are tas A ia oa See ee a ee 
USER GROUP | 
at | 
PRINT ‘SYSTEM | 
GROUP READY" : 
SEARCH FOR “STARTWUUP.EC” 
IN THE WORKING DIRECTORY 
SYSTEM GROUP ASSIGNED TO THE NEW GROUP 
IS NOW READY 
EXECUTE IT (A SAMPLE 
COMMAND FOLLOWS) 
COMMAND FILE 
PRINT: “USER 
GROUP READY" 
USER GROUP (S 
NOW READY 
a [% 
Figure 3-3 (cont). Flowchart of System Startup Process oY 
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Operator's Startup Actions 


The operator's actions at system startup are as follows: 


hs 


2% 


Set the central processor control panel POWER switch 
to ON. Turn on power for all devices. 


Ensure that the volume containing the Honeywell- 
Supplied system software is mounted on the bootstrap 
device. 


Perform the following bootstrap procedure at the central 
processor control panel: 


Ae 


b. 


Press Stop. 

Press CLeaR. 

Wait for CHECK light to go out. 

Press Load. 

Press Execute. 

Wait for the TRAFFIC light to turn off. 

If the bootstrap channel is not 0400 and/or if any of 
the bootstrap options shown in Table 3-2 are to be 
used, perform the following steps: 

(1) Press Stop. 

(2) Press Select. 


(3) Press Dl on the hexadecimal keypad, so that 
Dl appears in the LOCATION indicators. 


(4) Press Change. 


(5) Press appropriate keys on the hexadecimal 
keypad so that the CONTENTS indicators show the 
desired bootstrap channel and options. 


(6 ) Press Run. 
Press Execute 


The system is bootstrapped into main memory. (If the 
bootstrap halt option was specified in step e(5) 
above, the central processor halts, with Dl equal to 
what waS entered in step e(5), aS Soon as the system 
has been bootsStrapped; after performing any desired 
actions, again press Execute to continue. If Stop, 
Run, or Write was involved in these actions, press 
Run and Execute to continue.) 
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(In a Stage 1 system startup with an MLCP/DLCP- 
connected operator terminal, wait for the TRAFFIC 
light to turn off; then ensure that the Rl-register 
contains the proper line speed for the operator ter- 
minal and press Execute to continue.) | 


Table 3-2. Bootstrap Options 


Bits in Low-Order 
Digit of 4-Digit 
Hexadecimal Boot- 


Strap Channel 
Number Meaning if Bit Set ON*® 


15 After the initial bootstrap record is read from 
(low-order bit) the removable platter of the cartridge disk 
whose channel number iS contained in bits 0 
through 9, the remaining records are read from 
the fixed platter. 


Ignore CLM USER file if it exists under direc- 
tory SID. Instead, use the supplied file of 
CLM directives appropriate to the bootstrap 
device and terminal configuration (1.¢€., 

CLM MDC or CLM_MCP.) 


The central processor halts after the system is 
bootstrapped and before execution of the Execu- 
tive begins, and before execution of CLM. (To 
continue after the halt, press Execute.) 


“These bits may be set ON in any desired combination. Thus, the 
value of the low-order digit of the 4-digit hexadecimal boot- 
Strap channel number may range from 0 (no options) to 7 (all 
options). 


System Startup Actions 


system startup actions continue without further operator 
intervention. 


1. The Configuration Load Manager reads CLM directives from 
the appropriate file: 


a 


a. I 1 coeS not exist in directory SID on the 
bootstrap volume, one of the two Honeywell-Supplied 


files is used. 


(1) CLM MDC is used if the bootstrap volume is a 
cartridge disk, cartridge module disk, mass 
storage unit, or diskette, and one or more ter- 
minals are connected to an MDC. (The terminal 
with the lowest channel number will be used as 
the operator terminal.) 
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thn, 


Sx 


(2) CLM MCP is used if the bootstrap volume is a 
cartridge disk, cartridge module disk, mass 
Storage unit, or diskette, and one or more ter- 
minals are connected to an MLCP/DLCP. (The 
terminal with the highest channel number will be 


used as the operator terminal.) 


b. If CLM USER does exist under directory SID on the 
bootstrap volume, it will be used unless bit 14 of 
the bootstrap channel is set ON, in which case one 
of the system actions described under a (above) 1s 


followed. 


The system taSk group 1S created as if the following 
command had been executed, without user intervention: 


SG (Spawn group command) 
SS (task group id) 
OPERATOR.SYSTEM.OPR (user 1d) 
highest priority level (base priority level) 
+ 2 in CLM directive 
! CONSOLE (in path, also 

out path by default) 
-ECL (lead task) 
-LRN highest lrn in (highest Ilrn) 
CLM directive 
-~LFN 15 (highest lfn) 
-POOL system pool (memory pool) 
“WD “root directory if (initial working 
CLM directives were directory) 


read from CLM USER; 


SID if CLM direc- 
tives were read 
from 

CLM MDC or CLM MCP 


A system-supplied START UP.EC file is in directory SID; 
its operator commands are executed when a stage 1 sys- 
tem startup is performed (i.e., when CLM directives are 
read from CLM MDC or CLM MCP). Another system-Supplied 
START UP.EC file is immediately subordinate to the root 
directory of the bootstrap volume; its operator commands 
are executed when a Stage 2 system startup is performed. 
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CONF 


Both START UP.EC files cause a user task group (SH) to 
be spawned. The working directory for $H is HIS, which 
in turn contains a system-supplied START UP.EC file 


that performs a CWD (change working directory) to 
“root directory. 


Regardless of which file of CLM directives is used, 


the 


working directory for the system task group is always 


“root directory at the end of system startup. 


4. The system startup typeout (see Figure 3-2) is issued at 


the operator terminal. 


When system startup is complete, as signified by the system 
Startup typeout, operator commands may be entered to the system. 


IGURATION LOAD MANAGER ERROR REPORTING 


rect 


it i 
term 


teri 


ator 
dire 


m_ | 


Moe 


oper 


read. 


earl 


If, when the Configuration Load Manager is reading CLM di- 
ives from CLM USER, it detects that a directive contains a 
Syntax error or is an invalid duplicate of another CLM directive, 
ssues (if possible) a 2-line error message at the operator 


inal. The message has the format shown below: 
(SS) (l3yyzz) hh 


secondary message indicating the CLM directive causing 
the error 


yy - code identifying the system component that has 
detected the error 


ZZ - error code (see the System Messages manual) 


hh - priority level of the task group executing the 
Configuration Load Manager 


You can (if appropriate) bypass the error by typing * 


(as- 


sk) at the operator terminal and pressing RETURN. Other- 
wise, you must enter a correct CLM directive through the oper- 


terminal and press RETURN. The remainder of the CLM 
ctives in CLM USER will then be processed. 


An error message cannot be issued if an operator terminal is 
availabie because (i) the CLM DEVICE directive for an MDC- 
connected operator terminal has been omitted or (2) the operator 
terminal is connected to an MLCP/DLCP in which case it 1s not 
ational until system startup is complete or (3) the error 
occurred before the DEVICE directive defining the console was 


y in the CLM USER file.) In these cases, errors are 


(For this reason, it is important to place the directive 


reported through the hardware registers shown below, which are 


accessible through the central processor control panel. 


Section 5 in the Minicomputer Systems Handbook (CC71) for pr 
cedures to follow in reading out registers and memory locations. 


3215 


Refer to 


pro- 
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Rl-register contains yyzz (as described above) 


( ‘R2-register zero or a l-word secondary message in hexa- 
decimal notation 


B4-register zero or the address of the first word of a 
secondary message in ASCII notation (the 
left byte of this word is a control byte) 


B3-register zero or the address of the first word of the 
CLM directive causing the error provided the 
error occurred before the QUIT directive 


As described earlier in this section, in the event of an 
uncorrectable error in CLM USER, it is possible to return to a 
Stage 1 system startup (uSing the appropriate bootstrap option) 
and re-create a limited system environment in which M4 SYSDEF or 
the Editor can be used to correct the error in CLM USER. 


see Appendix A for information about other halts that are 
possible during system startup. 
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SECTION 4 


USING M4_SYSDEF 


M4 SYSDEF, an interactive program that generates a CLM direc- 
tive file, is provided for your convenience in creating the 
CLM USER file, and is fully described in this section. 


The system building CLM directives themselves are described 
in detail in Sections 5 and 6. Note that some of the direc- 
tives - and thus some of the MOD 400 software - are not Supported 
by M4 SYSDEF. See "M4 SYSDEF Operating Considerations", later in 
this section. ~ 


INTERACTIVE SYSTEM BUILDING PROGRAM 


The interactive CLM directive generation program M4 SYSDEF 
is designed to help you create the CLM directive file CLM USER. 
It converts information you give it, in response to its prompts, 
into the CLM directive file. M4 SYSDEF is designed to produce a 
directive file adequate for the average user and which will 
always result in an operable MOD 400 Executive. 


Although you can create the CLM directive file directly, 
uSing the Editor, Honeywell recommends that you use M4 SYSDEF, 
even if you have built the system before, because M4 SYSDEF: 


e Is interactive; it prevents you from forgetting any 
necessary information. 


e Tests each of your responses for validity. 


e Includes online explanations of each of its prompt 
messages. 


@e Ensures that a complete, properly ordered directive 
file is produced. 


e Allows you to interactively add, delete, or modify infor- 
mation you specify at any point in the program. 
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@e Performs all calculations of memory required by your 
Executive; the resulting memory sizes should never be 
less than your requirements. 


e Builds in all hardware devices Supported by Honeywell. 


e Generates, at your option, symbolic peripheral device 
names for all devices in your configuration. 


e Generates, at your option, channel number assignments 
for all noncommunications devices in your configuration. 


e Produces, at your option, a listing of the directive file 
at your terminal, before generating the final output file. 


@® Automatically generates a file containing configuration 
information that enables you to verify the success of cer- 
tain aspects of the system building process. 


e At your option, automatically configures all asynchronous 
communications devices (TTY and ATD) as being reconnect- 
able in the event of a power failure or line drop. 


Appendix M contains a checklist for your convenience in 
gathering the information M4 SYSDEF requires. Appendix C lists 
the hardware available under MOD 400. 


Required Resources 


M4 SYSDEF requires 10K words of memory to operate. It can 
run in the MOD 400 minimum system. 


M4-SYSDEF Operating Considerations 
You Should consider the following when executing M4 SYSDEF: 


1. If you allow M4 SYSDEF to dynamically assign channel 
numbers to your devices, you will only need to supply 
channel numbers for MLCP/DLCP - connected (communica- 
tions) devices. If you do not choose this option, you 
will be asked to explicitly specify channel numbers for 
all devices in your configuration. (See Section 5 for 
information on dynamically assigned channel assignments 
for non-communications devices.) 


2. If you choose to let M4 SYSDEF supply the channel numbers 
for all non-communications devices: 
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e M4 SYSDEF will assign the channel to be used for the 
operator terminal. If the operator terminal is to 
be an MDC-connected terminal, the program uses the 
device with the numerically lowest channel number as 
the operator terminal. If the operator terminal is 
to be an MLCP/DLCP-connected terminal, the program 
uses the device with the numerically highest channel 
number as the operator terminal. 


@ M4 SYSDEF will ask you to specify the type of device 
you plan to use as the boot device. 


If you do not choose to supply symbolic peripheral device 
(SPD) names, M4 SYSDEF automatically generates a unique 
SPD name for every device configured. If you choose to 
provide your own SPD names, M4 SYSDEF will ask you to 
Specify them as needed. ~ 


Honeywell recommends that you use the following 
Symbolic peripheral device (SPD) name conventions if 
you wish to provide your own SPD names: 


Symbolic 

Peripheral 

Device (SPD) 

Name Device 

LPTnn Line Printer 

SPTnn Serial Printer 

CONnn MDC-connected Terminal 
CDRnn Card Reader 

CRPnn Card Reader/Punch 

DS Knn Diskette 

RC Dnn Removable Cartridge Disk 
FCDnn Fixed Cartridge Disk 

FCMnn Fixed Cartridge Module Disk 
RCMnn Removable Cartridge Module Disk 
MSMnn Mass Storage Unit 

MT9nn Magnetic Tape (9-track) 
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4. Honeywell recommends configuring Distributed Systems 
Facilities software e.g., File Transmission Facility, 
HASP Workstation Facility, etc. after you have built your 
system the first time. This software is described in 
this manual's appendices. 


5. M4 SYSDEF doesn't Support the following: 


Configuration of dual-purpose operator terminal 
User-written line protocol handlers (LPHn) 
AutoCall Unit (ACU) 

7-track tape devices 

Device or memory error logging 


6. The program converts all lowercaSe characters in your 
responses to uppercase characters, unless you enclose the 
lowercase characters in apostrophes ('). 


7. When you enter channel a assignments, the program 
verifies that: 


@e The channel number is in the proper format (i.e., that 
it contains exactly four hexadecimal characters and 
ends with either "00" or "80") 


@® The channel number isn't already assigned to another 
device 


® The channel number isn't less than 0400 or greater 
than FF80 


Since there iS no requirement that system building take 
place upon the target machine, or that any specified 
device actually be attached to the machine when. M4. SYSDEF 
is executed, the program doesn't verify whether the spe- 
cified channel is actually connected to a device whose 
type matches the one in question. Therefore, if you 
enter invalid channel number assignments, the directive 
file will be in error. 


MODIFYING YOUR CLM DIRECTIVE FILE 
If you make mistakes in Specifying your directives when 
running the M4 SYSDEF program, or, if you wish to change, add, 


or delete information, you have several options for making 
modifications: 
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o You can interrupt the program at any point to modify 

- any portion of the CLM file. To do this, enter 

( ACABSH, and following the BREAK message, enter the 
program interrupt (PI) command. (It is assumed that 
you are entering the M4 SYSDEF program from the 
operator's terminal. If you are not at the operator's 
terminal, press the BREAK key, and following the BREAK 
message, enter the PI command.) The M4 SYSDEF program 
will respond by asking you which class of device or 
system parameter you wish to modify. Depending on your 
reply, the program will ask you only those questions in 
the M4 SYSDEF dialog that pertain to the specific device 
or system parameter that you wish to modify. 


o You can finish running the program and do one of the 
following: 


- Invoke M4 SYSDEF again, this time specifying the 
pathname of your restart file. The M4 SYSDEF pro- 
gram will enter rebuild mode and will ask you to 
Specify the class of device or system parameter 
you wish to modify. See "Using M4 SYSDEF in Rebuild 
Mode," below. y 


- Invoke M4 SYSDEF again and redefine the entire file. 


- Use the Editor to edit the file directly. 


USING M4 SYSDEF IN REBUILD MODE 


Using the M4 SYSDEF program in rebuild mode allows you to 
enter the program dialog at any point to make changes to an 
existing CLM file. The M4 SYSDEF program will only ask you 
those questions in the dialog that pertain to the specific 
device, class of devices, or system parameter that you wish to 
modify. Because you need not step through the entire M4 SYSDEF 
dialog in sequence to get to the section(s) you wish to modify, 
you can make random modifications quickly and easily. 


The first time you create a CLM file using M4 SYSDEF, the 
program generates a CLM directive file and a file containing 
information for the rebuild function, called the restart file. 
Each time you modify a CLM file, the M4 SYSDEF program creates a 
unique corresponding restart file under the same directory as 
your CLM file.' Whenever you terminate the M4 SYSDEF program 
normally the full pathnames of your CLM file and its correspond- 
ing restart file are displayed at your terminal. You never 


'There is no limit to the number of restart files that the 

M4 SYSDEF program creates. You must delete restart files 
co which are no longer needed with the delete file (DL) com- 
( mand, aS described in the Commands manual. 


4-5 CB 23-03 


asSign a name to the restart file - the M4 SYSDEF program does 

this for you automatically. You need only be aware of the path- e 
name of the restart file that corresponds to the CLM directive : 
file you wish to modify. 


If you wish to modify a CLM file at some later time, you 
Simply invoke M4 SYSDEF and specify the pathname of the corres- 
ponding restart file on the command line. The M4 SYSDEF program 
reads your reStart file and resets itself to the state defined 
in the restart file. See "M4 SYSDEF Dialog In Rebuild Mode" 
later in this section for a complete description of the rebuild 
mode dialog. 


OUTPUT OPTIONS 
You have several output options when using M4 SYSDEF: 


1. You can request M4 SYSDEF to list all the CLM directives 
it has built for you. If you spot any errors at this 
point (or at any point during the interactive dialogue) 
you can perform any one of the actions described above 
under "Modifying Your CLM Directive File". 


2. You have the option of creating a CLM USER file which 
contains the generated directives or you can terminate 
the interactive session. If you have not listed the CLM 
directives and you do not wish to create a file uSing 
them, M4 SYSDEF warns you that the directives will be 
lost and processing will terminate, and asks if this is 
what you intend. 


3. You have the option of giving your directive file a name 
other than the default file name CLM USER.’ After you 
Specify a file name, M4 SYSDEF creates the file under 
your current working directory, assumed to be (but not 
restricted to) directory SID in the rest of this section. 


Invoking M4 SYSDEF 


Before invoking M4 SYSDEF, you are required to transfer con- 
trol of the operator's terminal from the $S task group (the 
system operator's task group) to the $H task group (a system- 
Supplied user task group). (If the terminal 1S already under 
control of the $H task group, proceed to the paragraph below that 
describes how to change your working directory to the directory 
SID.) Enter the following lines at the operator's terminal 
immediately following system startup: 


'If a CLM file already exists in your working directory, 


M4 SYSDEF cautions you that your new CLM file will replace a 


the existing one, if both have the same file name. Me 
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Aen, 


ACATSH: (Transters control of the operator's 
terminal from $S to $H task group) 


RDN (The ready on (RDN) command causes a 
prompt message to appear at your 
terminal. This command is for con- 
venience only and is not required.) 


If you have entered RDN, the system will respond with the 
prompt message: 


(SH)RDY: 
Note that no prompt mesSage appears unleSS you specified RDN. 


Next, change your working directory to the directory SID by 
entering: 


CWD >SID 


Then invoke M4 SYSDEF by entering: 


M4 SYSDEF [path] 


where the optional argument [path] specifies the pathname of a 
System-—Supplied restart file. The pathname must be of the form 
M4RST.n where n is an integer. You specify this argument only 
if you wish to enter the M4 SYSDEF program in rebuild mode to 
modify an existing CLM file. See "M4 SYSDEF Dialog In Rebuild 
Mode" later in this section. 7 


You can terminate the interactive session at any time by 
entering ACABSH and then, following the BREAK message, uSing the 
unwind (UW) command. (It is assumed that you are at the 
Operator's terminal. If you are not at the operator's terminal, 
press the BREAK key, and following the BREAK message, enter the 
UW command.) If you make a mistake while creating the directive 
file, follow one of the options described elsewhere in this 
section under "Modifying Your CLM Directive File." 


Prompt Modes 


M4 SYSDEF operates in two prompt modes - long and short. In 
the long mode, each question is preceded by a multiline onscreen 
explanation of the question being asked. In the short mode, only 
the question is asked. Users of the short prompt mode who need 
help can see the long explanation printed as a "help message" by 
asking for help (see below). 


M4 SYSDEF asks you which mode you want to use when you invoke 
the program. If you select the long mode, the explanatory text 
appears only once. If the program repeats the question (because, 
perhaps, you answered it incorrectly), the short prompt is 
repeated unless you ask for help. It 1S recommended that first- 
time system builders execute M4 SYSDEF in the long prompt mode. 
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M4_SYSDEF DIALOGUE 


The short mode prompt messages which make up the M4 SYSDEF -_ 
dialogue are listed below, in order of their appearance. Unless 
otherwise noted, these responses are always acceptable: 

@ ? —- Help 


@® YES or Y - Yes (for yes/no questions) 


e NO or N - No (for yes/no questions) 
@ 0, NONE, or N —- None (for questions requiring a numeric 
response) 


A response of [C/R] (RETURN) is Never acceptable (i.e.;7. there are 
no default responses). 


Once you invoke M4 SYSDEF, it responds with: 


Hello! This tool will help you generate the file containing the 

Configuration Load Manager directives (the CLM USER file), which 

is necessary to build your GCOS6/MOD400 Operating System. Do you 
wish to use the long prompt mode? 


e In the long mode, every prompt message is preceded by the 
text of the "help" message, explaining what the requested 
information is, where you can find out if you have it or 
need it, and/or what will happen if you supply certain 
values. 


In the short prompt mode, only the prompt message is dis- 
played, unless you enter ?. Entering ? doesn't change the 
mode. 


e Acceptable answers are YES, Y, NO, or N. 


What is the total amount (in words) of real memory on the machine 
this system is to run on? Enter the value in the form: nonnk. 


e This value is the total amount of real (physical) memory 
installed on the machine for which this sys em is being 
built. The value you enter may differ fron -he amount of 
memory on the machine on which you invoke M4 SYSDEF. The 
minimum configuration for MOD 400 is 48K words. 


e Acceptable answers range from 48K to 1024K. Consult 


Appendix C for information about minimum system require- 
ments. 
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Do you 


wish the syStem to supply the channel numbers for non- 


(_ Communication devices? 


Every peripheral device attached to the system must have 
a megabus channel number assignment. The program can use 
the floating channel feature (See Section 5) to relieve 
you of the responsibility of assigning channel numbers to 
noncommunications devices; note, however, that you must 
always provide channel numbers for communications devices. 


Acceptable anSwers are YES, Y, NO, or N. 
If you reply YES, the program will ask you to supply 
device types for the operator's console and the boot 


device. 


If you reply NO, the program will prompt you to supply a 
channel number for each device in your configuration. 


Enter the channel number of the operator terminal which will be 
the CONSOLE. 


You must Specify the channel to which the operator's ter- 
minal is connected. M4 SYSDEF verifies for you that this 
channel number has not already been assigned to another 
device. However, only you can verify that the specified 
channel is actually connected to the terminal designated 
as the operator terminal for your installation; M4 SYSDEF 


cannot check this information for you. 


The channel number specified must consist of four hexa- 
decimal characters ending in '00' or ‘'80O'. 


Enter the channel number of the boot device. 


Do you 


You must specify the channel number of the drive on which 
you mount the disk containing the system software. 


The channel number specified must consist of four hexa- 
decimal characters ending in 'OO' or ‘'80O'. 


This prompt does not appear if you specified that 

M4 SYSDEF will supply the channel numbers for all 
non-communications devices in your configuration. 
wish to boot the fixed platter? 

This prompt applies only if you wish to boot from the 
fixed platter of a cartridge disk or cartridge module 


disk. 


Acceptable answers are YES, Y, NO, or N. 
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Is this a Commercial System? Reply "yes" or "no". 

e If you have a Model 47 or Model 57 central processor, 
answer YES. If you have any other model central pro- 
cessor, you must answer NO. 

e Acceptable anSwers are YES, Y, NO, or N. 

e If you respond NO to this question, the program replies: 

Will this system have a Commercial simulator? 

e If your system isn't a commercial system, it may require 
the commercial instruction simulator. Otherwise, it won't 
be able to execute commercial instructions (used, for 
instance, by intermediate COBOL). 

e Acceptable ansSwers are YES, Y, NO, or N. 


Will this system have a SIP? Reply "yes" or "no". 


e The SIP is the Scientific Instruction Processor software 
option. 


e Acceptable anSwers are YES, Y, NO, or N. 
e If you reply NO to this question, the program replies: 


Will this system have a Simulator for the SIP? Reply "“yes" or 
sn a 6 tae ‘ 


e Acceptable anSwers are YES, Y, NO, or N. 


e If you reply NO, then the system won't be able to Support 
scientific instructions (used, for instance, in FORTRAN). 


e If you replay YES to this question, the program replies: 
Do you want the double precision simulator SIPSIM? 

e Acceptable ansers are YES, Y, NO, or N. 

e If you reply yes, the double-precision simulator will give 
you twice as many Significant digits in your FORTRAN cal- 
culations as the sSingle-precision Simulator. (If you 
chose this option, be aware that numerical values stored 


in memory will take up twice as much space as values 
Stored for the Single-precision Simulator). 
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The default system identification is 'GCOS6/MOD400'. If you wish 
to change it, reply 'YES'; if you do not wish to change it, reply 


INOS 2 


Do you? 

The system identification message appears aS a comment 
line near the top of the CLM file that M4 SYSDEF generates 
for you. You may, if you wish, customize this message for 
your installation's CLM directive file. 


Acceptable answers are YES, Y, NO, or N. 


If you reply YES to this question, the program replies: 


Enter the new System Identification (30 characters or less) in 
the form: 'SYSTEM IDENTIFICATION! 


You must enclose the entire string in apostrophes, as 
Shown. 


The default installation identification is 'Your Town , USA'. If 
you wish to change it, reply 'YES'; if you do not wish to change 
it, reply 'NO'. Do you? 


The installation identification message appears aS a 
comment line near the top of the CLM file that M4 SYSDEF 
generates for you. You may, if you wish, customize this 
message for your installation's CLM directive file. 


Acceptable answers are YES, Y, NO, or N. 


If you reply YES, the program responds: 


Enter the new installation identification (30 characters or less) 


in the 


Please 
expect 


form: "Installation id' 


You must enclose the entire string in apostrophes, as 
Shown. 


enter the maximum number of concurrent users that you 
this system to Support. 


This value allows for the calculation of some of the sys- 
tem structure sizes and memory needs which vary depending 
upon the maximum load for which the system is to be built. 
M4 SYSDEF assumes that the number of users is synonymous 
with the number of task groups. 


Note that entering a given number here does not guarantee 
that the maximum number of concurrent users can in fact 

be supported. This depends on such dynamic variables as 
the work each user is performing and memory fragmentation. 


Nonnumeric characters are not acceptable in this answer. 
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Should I automatically generate the SPD names for you? 


e Each peripheral device attached to the system must have a 
Symbolic peripheral device name. This entry is a five- 
character! name which conforms to the file system naming 
conventions. 


e Acceptable anSwers are YES, Y, NO, or N. 


e If you reply YES, the program will generate 5-character 
SPD names without further prompting. If you reply NO, the 
program will prompt you to supply an SPD name for every 
device in your configuration. 


Do you wish this system to activate the Record Locking Feature of 
Data Management? 


® Record locking is the finest granularity of concurrency 
control provided by data management. Activation of this 
runtime option allows more than one uSer to write records 
to a given file simultaneously. Proper usage of this 
option ensSures that all updates are correctly applied to 
the file. 


® Acceptable anSwers are YES, Y, NO, or N. 


e If you reply YES, record locking iS implemented. If you 
reply NO, data management will enforce file level con- 
currency (i.e., only one uSer can have write permission 
on a file at one time). 


Do you wish to include Display Formatting and Control Software? 


® ‘the Display Formatting and Control software is described 
in the Display Formatting and Control manual and In 


Appendix P of this manual. 
® Acceptable answers are YES, Y, NO, or N. 


® iff you replay YES, the display processing software will be 
included in your Executive. If you reply NO, no display 
processSing software will be included. 


Tee een an mam erase teem cqmaenel nati cement oom 


"Acceptable ranges are from 5 to 12 characters (6 for disks); 
however, for consistency, Honeywell recommends using 5-character 
Symbolic peripheral device names. 


4>12 CB235=0'3 


Do you wish to activate the power fail restart? 


This prompt asks if you wish to configure the power 
resumption facility. The power resumption facility allows 
the system execution environment to be restarted after a 
power interruption, if fewer than two hours have elapsed 
when power is returned to the central processor. For more 
information, refer to Appendix D. 


If you reply YES, each ATD and TTY communications 
(MLCP/DLCP-connected) device in your configuration will 
be automatically reconnected if a power resumption or 
line drop condition occurs. (Peripheral devices not 
attached to an MLCP/DLCP are automatically designated as 
reconnectable when they are configured.) 


If you reply NO, no automatic reconnection of MLCP/DLCP- 
connected terminal devices will occur. 


Does this system have any communications type devices? i1.e., 


VIP's, 


TTY'sS, etc. 

Acceptable answers are YES, Y, NO, and N. 

A communications device is an MLCP/DLCP-connected device. 
If you reply NO, the program skips to the prompt. "How 
many MDC-connected console devices do you have?", later in 


this dialogue. If you reply YES, you will see the follow- 
ing prompts. 


How many communications priority levels (1 to 4) do you wish? 
Enter the number of levels. 


Each device must be assigned to a hardware interrupt 
level. Noncommunications devices must be assigned’ to 
unique interrupt levels; M4 SYSDEF can perform this 
assignment for you. However, communications devices can 
share a priority level; therefore, you are given a chance 
to specify relative priority levels for each communica- 
tions device. 


Acceptable answers are l, 2, 3, or 4. If you specify 1, 
all communications devices will share one interrupt level. 
If you specify 2 through 4, you will have the capability 
to assign specific devices to different levels, with those 
devices on level 1 having the highest relative priority 
and those devices on level 4 having the lowest relative 
priority. You do not have to assign at least one device 
to each level; M4 SYSDEF reserves any unused levels for 
you. 


4-13 CB23-03 


How many MLCP's (1 to 10) will this system have? 


e All communications devices must be attached to a multi- 
line communications processor (MLCP). 


e Acceptable answers are 1 through 10, inclusive. 
How many ATDS do you have? 


e The program is now attempting to configure all MLCP/DLCP 
Connected asynchronous terminal devices. 


e The following asynchronous terminal devices are supported: 


VIP 7200, VIP 7205, VIP 7801, VIP 7802, VIP 7207, PRU1OC1, 
- PRU1003, PRU1005, TWU1001, TWU1003, TWU1005, and various 
teleprinter-compatible devices. 


e If you reply NONE, the program skips to the prompt, “How 
many VIP's do you have?", below. 


e If you reply with a nonzero number, the program continues: 
ATD terminal number N 
e This message, and the three prompts following it, appear 
N times, where N iS your response to the earlier question, 
“How many ATDsS do you have?". 


What channel number will this device be on? 


e You must enter exactly four hexadecimal characters, ending 
in '0O0' or ‘'80°'. 


Enter the communications priority level for this terminal. 
e Acceptable answers range from 1 through your response to 
the earlier question, “How many communications priority 


levels (1 to 4) do you wish?". 


e If you specified only one communications priority level, 
this prompt won't appear. 
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What is 


the device type for this ATD device? 


e You must specify one of the following values (there is no 
default): 

Value Physical Device Type 

7200 VIP 7200, VIP 7205 

7801 VIP 7801, VIP 7802 

D7 200 VIP 7207 

PRU PRU 1001, PRU1003, PRU 1005, 

TWU 1001, TWU1003, TWU 1005 
TTY Can be any asynchronous terminal device- 
type classified as teleprinter compatible 
How many VIP's do you have? 

e The program iS now attempting to configure synchronous 
terminals. The following synchronous terminals are sup- 
ported by M4 SYSDEF: 

VIP 7700 

VIP 7700R/VIP 7705R 

VIP 7760 

VIP 7804/VIP 7805 (in VIP 7700 mode) 

e To use the extended features of the VIP 7804 or VIP 7805, 
you may want to use an STD directive. STD groups are 
configured later on in the M4 SYSDEF dialog. 

e If you reply 0, the program skips to the prompt, "How 
many H3270 Host Links do you have?", below. 

e If you reply with a nonzero number, the program continues: 

VIP terminal number N 

e@ This message, and the seven prompts following it, appear 
N times, where N is the number you entered in response to 
the earlier question, “How many VIP's do you have?". 

What channel number will this device be on? 

e You must provide the Megabus channel number to which this 
device is attached. 

e You must enter exactly four hexadecimal characters, ending 
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How many VIP's are polled on this channel? 
e ? is not acceptable here. 


@e Acceptable answers are the numbers 0 through 3l, 
inclusive. 


Enter the communications priority level for this terminal. 
e ? is not acceptable here. 
e Acceptable answers range from 1 through your response to 
the earlier question, "How many communications priority 


levels (1 to 4) do you wish?". 


e If you specified only one communications priority level, 
this prompt won't appear. 


Enter the polling address for this VIP. 

e Acceptable answers are 0 through 31, inclusive. 

e This prompt appears only if you specified a non-zero value 
for the prompt “How many VIP's are polled on this 
Channel?", above. 

Is this VIP a ‘Control Station'? 

e ? is not acceptable here. 

e Acceptable answers are YES, Y, NO, or N. 
Does this VIP have a ROP Mmeceivesoniy Printer)? 


e Acceptable answers are YES, Y, NO, or N. 


e If you reply NO, the program skips the next two prompts. 
If you reply YES, the program continues: 


What type of ROP do you have? 


e There are eight Supported ROPs: 


Devices Supported 
Specify One (See Appendix C) 
TN100 TermiNet 100 or PRU 1001 
TN300 (default) TermiNet 300 or PRU 1003 
TN1200 TermiNet 1200 or PRU 1005 
TTY 33 ASR-33 
TTY35 | ASR-35 
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Does this ROP Support form feed? 

e ? is not acceptable here. 

e Acceptable anSwers are YES, Y, NO, or N. 
How many H3270 Host Links do you have? 


e The program is now attempting to configure stations for 
the BSC 3270 line protocol handler in your configuration. 


e Acceptable anSwers are a nonzero number or NONE. 


e If you reply NONE, the program skips to the prompt, 
“How many PVE groups do you have?", below. 


e If you reply with a nonzero number, the program continues: 
H3270 line number N 
e This message, and the 4 prompts following it, appear N 
times, where N is the number you entered in response to 
the earlier question, “How many H3270 Host Links do you 
have?". 


What channel number will this line be on? 


e You must provide the Megabus channel number to which this 
line is attached. 


e You must enter exactly four hexadecimal characters, ending 
in: '00* or *80"* 


Enter the communications priority level for this line. 
® ? iS not acceptable here. 
e Acceptable answers range from 1 through your response to 
the earlier question, "How many communications priority 


levels (1 to 4) do you wish?". 


e If you specified only one communications priority level, 
this prompt won't appear. 


Enter the polling address (decimal) for this H3270 Host Link. 
e ? is not acceptable here. 
® Acceptable answers range from 0 through 255, inclusive. 


M4 SYSDEF converts this number to a hexadecimal value 
for you when it defines the H3270 directive. 
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Enter the select address (decimal) for this H3270 Host Link. 


e ? 1S not acceptable here. 

e Acceptable answers range from 0 through 255, inclusive. 
M4 SYSDEF converts this number to a hexadecimal value 
for you when it defines the H3270 directive. 


How many PVE groups do you have? 


e The program is now attempting to build facilities for 
polled VIP emulated (PVE) groups into your configuration.' 


e If you reply “NONE", the program skips to the prompt, 
"How many STD groups do you have?". 


e If you reply with a nonzero number, the program continues: 


PVE group number N 


e This message, and the four prompts following it, appear 
N times, where N is your response to the earlier question, 
“How many PVE groups do you have?". 
Enter channel number for PVE group N 


e ? iS not acceptable here. 


e You must enter exactly four hexadecimal characters, ending 
iin “010 oF. @80*:. 


How many PVE stations are there on this enannel? 
e ? is not acceptable here. 
e Acceptable answers are 1 through 32, inclusive. 
Enter the communications priority level for this group. 
e ? iS not acceptable here. 
e Acceptable answers range from 1 through your response to 
the earlier question, “How many communications priority 


levels (1 to 4) do you wish?". 


e If you specified only one communications priority level, 
this prompt won't appear. 


'A PVE group consists of all the PVE stations assigned to the 
same hardware channel. 
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Enter the polling address (0 to 31) for PVE station N 
( e ? is not acceptable here. 
e Acceptable answers are 0 through 3l, inclusive. 


e The prompt appears N times, where N is your response to 
the earlier question, "How many PVE groups do you have?". 


How many STD groups do you have? 


e The program is now attempting to configure all MLCP/DLCP 
connected synchronous terminal devices. 


e The following synchronous terminal devices are 


Supported: VIP 7804, VIP 7805, VIP 7700, VIP 7700R, 
VIP 7705R, and VIP 7760. 


e If you reply NONE, the program skips to the prompt: 
"How many MLCP-connected Binary Synchronous Commun- 
ications (BSC) lines do you have?", below. 


e If you reply with a nonzero number, the program 
continues: 


STD group number N 


e This message, and the 8 prompts following it, appear 
N times, where N is your response to the earlier ques-— 
tion, “How many STD groups do you have?". 
Enter channel number for STD group N 


e You must enter exactly four hexadecimal characters, 
ending in 'O0O' or ‘80°. 


Enter the communications priority level for this group 
e Acceptable answers range from 1 through your response 
to the earlier question, “How many communications 


priority levels (1 to 4) do you wish?". 


e If you specified only one communications priority 
level, this prompt won't appear. 


How many STD stations are there on this channel? 
e The reply "?" is not acceptable here. 


e Acceptable answers are 1 through 32, incluSive. 


4-19 CB23-03 


Enter the polling address (0 to 31) for STD station N 
e ? is not acceptable here. 
e Acceptable answers are 0 through 31, inclusive. 
e The prompt appears N times, where N is your response 
to the earlier question, "How many STD groups do you 
have?". 


What is the device type for this STD device? 


e You must specify one of the following device types: 


Device Type Supported Devices 
V7804 VIP 7804, VIP 7805 
V7700 VIP 7700, VIP 7700R, VIP 7705R 
V7760 VIP 7760 


Does this STD have a ROP (Receive-only printer)? 


e If you reply NO, the program skips the next prompt. 
If you reply YES, the program continues: 


What type of ROP do you have? 


e There are four supported ROPs: 


Specify One Devices Supported 
ROSY24 PRU 1003 
ROSY 26 PRU 1005 
TN 300 TermiNet 300 
TN1200 TermiNet 1200 


How many MLCP-connected Binary Synchronous Communications (BSC) 
lines do you have? 


e The program is now attempting to build facilities for BSC 
lines into your configuration. 


e ? 1S not acceptable here. 


e If you reply 0, the program skips to the prompt, "How 
many MDC-connected console devices do you have?", below. 


e If you reply with a nonzero number, the program continues: 
BSC line number N 
e This message, and the three prompts following it, appear 


N times, where N iS your response to the earlier question, 
“How many MLCP-connected BSC lines do you have?". 
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What channel number will this device be on? 


( e ? iS not acceptable here. 


e You must enter exactly four hexadecimal characters, ending 
in 'OO' or '80'. 


Enter the communications priority level for this terminal. 
e ? iS not acceptable here. 
e Acceptable answers range from 1 through your response to 
the earlier question, “How many communications priority 


levels (1 to 4) do you wish?". 


e If you specified only one communications priority level, 
this prompt won't appear. 


Is this BSC line a 'Primary' one? 
e ? 1S not acceptable here. 
e Acceptable answers are YES, Y, NO, or N. 
How many MDC-connected console devices do you have? 


4 e The program is now attempting to build facilities for all 
H MDC-connected terminal devices. 


e If you reply NONE, the program skips to the prompt, "How 
Many diskettes do you have?", below. 


e If you reply with a nonzero number, the program continues: 
CON number l 
What channel number will this device be on? 


e ThiS prompt appears only if you are explicitly entering 
Channel numbers. 


e This prompt appears N times, where N is your response to 
the earlier question, "How many MDC-connected console 
devices do you have?". : 


e You must enter exactly four hexadecimal characters, 
ending ain. “00° -or 80? < 


What is the device type for the Operator's CONSOLE? 


@ You must specify one device as the Operator's terminal: 
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Value Physical Device Type 


7200 VIP 7200 (DKU9103) 
VIP 7205 (DKU9102) 


The value 7200 must be used if MDC- 
connected VIP 7200 terminals are to 
be used for forms procesSing uSing 
the Display Formatting and Control 


Facility. 
PRU PRU1003/PRU1005/TWU1003/TWU1005 
D7200 VIP 7207 
KSR The terminal is to be supported in 


teleprinter mode. 


7801 VIP 7801, VIP 7802 


CON number N 


This message, and the two prompts following it, appear 
N —- 1 times, where N is your response to the earlier 
question, "How many MDC-connected console devices do 


you have?". 


What channel number will this device be on? 


You must enter exactly four hexadecimal characters, ending 
in '00' or ‘80°. 


This prompt appears only if you are explicitly entering 
channel numbers. 


? 1S not acceptable here. 


What is the device type for this CON device? 


Specify one of the values previously described for CON 
number 1l. 


How many diskettes do you have? 


The program is now attempting to build facilities for 
diskette devices into your configuration. (See Appendix 
C for a list of diskette device.) 


If you reply 0, the program skips to the prompt,"How many 
cartridge disks to you have?", below. 


If you reply with a nonzero number, the program continues: 


4-22 CB23-03 


Diskette number N 
What channel number will this device be on? 


( e This prompt only appears if you are explicitly entering 
Channel numbers. 


e This prompt appears N times, where N is your response to 
the earlier question, “How many diskettes do you have?" 


e ? iS not acceptable here. 


e You must supply exactly four hexadecimal characters, 
ending in '00' or '80'. 
How many cartridge disks do you have? 
e The program is now attempting to build facilities for 
Cartridge disk devices into your configuration. (See 


Appendix C for a list of cartridge disk devices.) 


e Your configuration must have at least one cartridge disk, 
Cartridge module disk, or maSs Storage unit. 


e® If you reply 0, the program skips to the prompt, "How 
many cartridge module disks do you have?", below. 


e If you reply with a nonzero number, the program continues: 
{ Cartridge Disk number N 
e This message, and the two prompts following it, appear N 
times, where N is your response to the earlier question, 
"How many cartridge disks do you have?". 


What channel number will this device be on? 


e This prompt only appears if you are explicitly entering 
Channel numbers. 


@® ? 1S not acceptable here. 


® You must supply exactly four hexadecimal characters, 
ending in. *00* or "80", 


Does this Cartridge Disk have a fixed platter? 
® ? is not acceptable here. 
e Acceptable answers are YES, Y, NO, or N. 
How many cartridge module disks do you have? 


cartridge module disks into your configuration. (See 


( : --@ The program is now attempting to build facilities for 
a Appendix C for a list of cartridge module disks.) 
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e If you reply 0, the program skips to the prompt, “How many 


Storage modules do you have?", below. 


If you reply with a nonzero number, the program continues: 


Cartridge Module Disk Number N 
What channel number will this device be on? 


This prompt only appears if you are explicitly entering 
channel numbers. 


This prompt appears N times, where N is your response to 


the earlier question, "How many cartridge module disks do 
you have?". 


2? 1S not acceptable here. 


You must supply exactly four hexadecimal characters, 
ending in. "00" or *80:". 


How many Storage modules do you have? 


The program iS now attempting to build facilities for mass 
Storage devices into your configuration. (See Appendix C 
for a list of mass storage devices.) 


If you reply NONE, the program skips to the prompt, “How 
many card reader/punches do you have?", below. 


If you reply with a nonzero number, the program continues: 


otorage Module number N 
What channel number will this device be on? 


This prompt only appears if you are explicitly entering 
channel numbers. 


This prompt appears N times, where N is your response to 
the earlier question, “How many Storage modules do you 
have?" 


2? 1S not acceptable here. 


You must enter exactly four hexadecimal characters, ending 
an: * O00". or 80" 


How many card readers do you have? 


The program 1S now attempting to build facilities for card 
reader devices into your configuration. (See Appendix C 
for a list of card reader devices.) 


If you reply 0, the program skips to the prompt, "How many 


card reader/punches or punches do you have?", below. 
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If you reply with a nonzero number, the program continues: 


Card reader number N 
What channel number will this device be on? 


This prompt only appears if you- are explicitly entering 
Channel numbers. 


This prompt appears N times, where N is your response to 
the earlier question, "How many card readers do you 
have?". 


2 1S not acceptable here. 


You must Supply exactly four hexadecimal characters, 
ending in '00' or '80'. 


How many card reader/punches or punches do you have? 


The program iS now attempting to build facilities for card 
reader/punch devices or card punch devices into your con- 
figuration. Note that "card reader/punch" doesn't mean 
card readers or card punches, but devices that both read 
and punch cards. (See Appendix C for a list of card 
reader/punch devices.) 


If you reply 0, the program skips to the prompt, "How many 
printers do you have?", below. 


If you reply with a nonzero number, the program continues: 


Card reader/punch or punch number N 
What channel number will this device be on? 


This prompt only appears if you are explicitly entering 
channel numbers. 


? 1S not acceptable here. 
This prompt appears N times, where N is your response to 
the earlier question, "How many card reader/punches or 


punches do you have?". 


You must supply exactly four hexadecimal characters, 
ending in '00' or '80'. 


How many printers do you have? 


The program is now attempting to build facilities for 
line printer devices into your configuration. (See 
Appendix C for a list of line printer devices.) 


If you reply 0, the program skips tn the prompt, "How 
many 9-track magnetic tape devices do you have?", below. 
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If you reply with a nonzero number, the program continues: 


Printer number N 
What channel number will this device be on? 


This prompt only appears if you are explicitly entering 
Channel numbers. 


This prompt appears N times, where N is your response to 
the earlier question, "How many printers do you have?". 


2? 1S not acceptable here. 


You must supply exactly four hexadecimal characters, 
ending in '00' or ‘'80'. 


How many 9-track magnetic tape devices do you have? 


The program is now attempting to build facilities for 
Q9-track magnetic tape devices into your configuration. 


(See Appendix C for a list of 9-track magnetic tape 
devices.) 


If you reply 0, the program skips to the prompt "do you 
wish to have ALL system overlays resident (yes or no)?", 
below. 


If you reply with a nonzero number, the program continues: 


Magnetic Tape Device number N 
What channel number will this device be on? 


This prompt only appears if you are explicitly entering 
Channel numbers. 


This prompt appears N times, where N is your response to 
the earlier question, "How many 9-track magnetic tape 
devices do you have?". 


2? is not acceptable here. 


You must supply exactly four hexadecimal characters, 
ending in '0O0O' or ‘'80'. 


wisn to have ALL system overlays resident? (yes or no) 
Acceptable answers are YES, Y, NO, or N. 

If you answer yes, the system optimizes the execution 
speed of all functions; the resulting system will occupy 
more memory than a system without resident overlays. The 
program skips to the prompt, "Do you wish to create a 
batch memory pool?" 


If you answer no, the program continues: 
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Do you wish to optimize the reading/writing of relative files? 


By making particular system input/output overlays perma- 
nently resident, you can obtain optimum speed for selected 
file types. This prompt, and the six that follow, ask if 
you wish to optimize the execution speed necesSSary to per- 
form different functions. 

Acceptable answers are YES, Y, NO, or N. 

wish to optimize the reading/writing of random files? 
Acceptable answers are YES, Y, NO, or N. 

wish to optimize the reading/writing of indexed files? 
Acceptable answers are YES, Y, NO, or N. 

wish to optimize relative files with deletable records? 
Acceptable answers are YES, Y, NO, or N. 

wish to optimize file management open/close functions? 
Acceptable answers are YES, Y, NO, or N. 

wish to optimize the reading/writing of tape files? 


Acceptable answers are YES, Y, NO, or N. 


This prompt appears only if you previously specified 
that your system supports magnetic tape devices. 


wish to optimize EBCDIC tape functions? 

Acceptable answers are YES, Y, NO, or N. 

wish to create a batch memory pool? 

Acceptable answers are YES, Y, NO, or N. 

If you answer no, the program skips to the prompt, “Enter 


the number (1 to 10) of 320-word system overlay areas you 
desire", below. If you answer yes, the program continues: 


How big a batch pool? (nnnnn or nnk words) 


Nonnumeric characters (except for "k") are not acceptable 
here. 


You must supply a numeric value of the form nnnnn or nnk 
words. 
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Enter the number (1 to 99) of system overlay areas you desire. 


Nonnumeric characters are unacceptable here. 


The number of system overlays that you specify will be 
loaded into the system area of memory where they will 
remain resident for the duration of the configured system. 
The larger the number of system overlays is, the more 
likely it is that frequently used system overlays will be 
found in memory. 


Would you like to see the generated statements? 


Do you 


Acceptable answers are YES, Y, NO, or N. 


If you answer yes, M4 SYSDEF lists the contents of the 
file of CLM directives it has generated for you. At the 
top of the listing (below the SYS directive statement) the 
program identifies for you the version of M4 SYSDEF that 
you are uSing, aS well as the date and time that your CLM 
directive file was generated. 


If you spot an error at this point, you can enter rebuild 
mode by hitting the break key and then typing the command 
PI (program interrupt). See "M4 SYSDEF Dialog In Rebuild 
Mode" later in this section. 7 


If you answer no, the program continues: 
want to create a CLM directive file now? 
Acceptable anSwers are YES, Y, NO, or N. 


If you reply no to both this question and the preceding 
question, the program warns you that the directives will 
be lost and processing will terminate, and asks if this 
1S what you intend. If you reply yes, this is what you 
intend, processing terminates, and no directive file is 
created. If you reply no, the previous question, "Would 
you like to see the generated statements?", 1s repeated. 


If you reply no to this question but replied yes to the 
preceding question, processing terminates. 


If you reply yes, the M4 SYSDEF program automatically 
generates a map file for you, containing configuration 
information you may find useful. (For a complete explana- 
tion of the map file, refer to the description of the 

MAP directive in Section 5.) The program assigns this 
map file the pathname >SID>CLM MAP. If you wish to 
examine CLM MAP after you create your CLM file, you can 
use a print (PR) command or invoke the Editor and use 

the Editor's read and print directives. 


If you reply yes, the program continues: 
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you like to use a file name other than CLM USER for this 


Acceptable anSwers are YES, Y, NO, or N. 


You may wish to use the default file name CLM USER or a 
file name of your own. If you answer no, M4 SYSDEF cre- 
ates CLM USER under your current working directory SID 
and processing terminates. 


If this file already exists in your current working 
directory, M4 SYSDEF informs you and gives you the option 
of guitting, re- writting the file, or providing another 
file name. 


Note that although you are free to rename your CLM file, 
the system must be able to locate a file named CLM _USER 
under directory SID at system startup. Renaming your CLM 
file allows you the option of creating more CLM files 

than just the one your system needs at configuration time. 
You may, for example, be creating CLM files for several 
installations, in which case you may want each one to have 
a unique name for identification purposes. 


If you answer yes, the program continues: 


your filename -- 


The file name you choose must be no longer than 12-char- 
acters and must conform to standard file name conventions. 


After you enter your file name, M4 SYSDEF creates your CLM 
file under your working directory SID, and processing 
terminates. The program lists the full pathnames of the 
CLM file and its corresponding restart file at your ter- 
minal. If, at some later time you wish to modify your CLM 
file, see "Using M4 SYSDEF in Rebuild Mode", earlier in 
this section. 


If this file already exists in your current working 
directory, M4 SYSDEF informs you and gives you the option 
of quitting, re-writting the file, or providing another 
file name. 


M4_SYSDEF DIALOG IN REBUILD MODE 


Once you invoke M4 SYSDEF and specify the pathname of a 
restart file, the program responds with: You have entered 


M4 SYSDEF in the rebuild mode. Do you want to see the existing 
CLM statements? 


If you respond YES, the program lists the CLM directives 
contained in your restart file. 


If you respond NO, the program continues: 
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Do you wish to modify devices or system parameters? 
Respond with "SYSTEM", "DEVICES", "VIEW", or "DONE". 
Response = 


Depending on your response, the program will enter 

the M4 SYSDEF dialcg at the appropriate place so 

you can make modifications. Table 4-1 lists each ques- 
tion and response in the rebuild mode dialog. The com- 
plete M4 SYSDEF dialog is described earlier in this 
section. — 


If you respond SYSTEM, the program asks the question, 

“Do you wish to modify the prompt (PROMPT), memory 

Size (MEMORY), the number of interactive users (USERS), 
the automatic generation of SPD names (SPD), the auto- 
matic channel assignment (CHANNEL), the record locking 
feature (RLOCK), the system overlay areas (SOAT), the 
resident overlays (RESOLA), the display formatting feature 
(VDAM), the commercial or SIP simulators (SIMUL), or the 
System and installation identification (IDENT)? Depending 
on your response to this question, the program will enter 
the M4 SYSDEF dialog at the appropriate place so you can 
make modifications. Once you have finished making your 
modifications, enter the reply DONE. 


If you respond DEVICES, the program asks the question, 
“Respond with the device type or class that you wish to 
modify. "COMM", "CON; ~OSK™., "RCD", "MSM", "CMD", "CDR", 
"CRP", "LPT", “MTP", or "DONE". Depending on your 
response to this question, the program will enter the 

M4 SYSDEF dialog at the appropriate place so you can make 
modifications. If you reply DONE, the program will repeat 
the prompt, "Do you wish to modify devices or system 
parameters?" When you have finished making your modifi- 
cations, enter the reply DONE. 


If you reply VIEW, the program lists the current CLM 
file at your terminal. 


If you reply DONE, the program skips through the M4 SYSDEF 
dialog to the prompt, "Would you like to see the generated 
Statements?" Normal M4 SYSDEF termination prompts follow. 


When M4 SYSDEF processing terminates normally, the program 
will list the pathnames of your CLM directive file and 

its associated restart file. If you wish to modify this 
CLM file at some later time, you invoke M4 SYSDEF, 
specifying the pathname of this restart file on the com- 
mand line. 
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sein, 


Table 4-1 lists each question and response in the rebuild 


mode dialog. Using this table, you can trace 


each of your 


possible responses to a specific entry point in the M4 SYSDEF 


program dialog. 


To use this table, begin in the left hand 
across to the right. Note that the questions 
to answer become more specific aS you isolate 
section of the M4 SYSDEF dialog that you wish 


column and read 
you are required 
the specific 

to enter. The 


fifth column lists the actual questions in the M4 SYSDEF program 
dialog that appear aS a result of your responses to previous 


rebuild mode questions. Column six lists the 


pages in this 


section of the manual that explain each M4 SYSDEF question in 


detail. 
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(Question 


Do you wish to modify devices 
or syStem parameters? Respond 
with "SYSTEM", "DEVICES", 
"VIEW", or “DOUNE". 


Table 4-1 Rebuild Mode Dialog 


Rebuild Mode Dialog M4 SYSDEF Dialog 


SYSTEM 


DEVICES 


Page 


Do you wish to modify the prompt (PROMPT), Do you wish to use the long prompt mode? 
memory Size (MEMORY), the number of inter- 
active users (USERS), the automatic gen- MEMORY What is the total amount (in words) of 


eration of SPD names (SPD), the automatic real memory on the machine this system 
channel assignment (CHANNEL), the record is to run on? fkniter the valué in the 
locking feature (RLOCK), the system over- form: nnnk. 


lay areas (SOAT), the resident overlays 
(RESOLA), the display formatting feature USERS Please enter the maximum number of con- 


& 
| 
ro) 
in) 


(VDAM) , the commercial or SIP Simulators current users that you expect this sys- 
(SIMUL), or the system and installation tem to Support. 


identification (1DENT)? 
Snould I automatically generate the SPD 4-12 
names for you? 


CHANNEL | Do you wish the system to supply the 
channel numbers for noncommunications 
devices? 


RLOCK Do you wish this system to activate the. 4-12 
Record Locking Feature of Data Manage- 
ment? 

SOAT Enter the number of system overlay areas 
you deSire. 

RESOLA Do you wish to have all system overlays 
resident? 

VDAM Do you wish'to include Display Formatt- 
ing and Control Software? 

SIMUL Is this a commercial system? 4-10 
Reply "YES" or "NO". 


IDENT The default system identification is 4-1] 
"GCOS6/MOD400'. If you wish to change 
it, reply 'YES'; if you do not wish to 
change it, reply 'NO'. Do you? 


Do you wish to modify the communications | COMM, 4-13 
you wish to modify. "COMM", "CON", “DSK" levels and the number of MLCP's (CQMM) VIP, 4-15 
"RCD", "MSM", “CMD", "CDR", "CRP", "LPI", (see note), the vip's (VIP), the Host H3270, 4-17 
"MIP", or “DONE”. Links 8H3270), the pve's (PVE), the syn 

chronous terminals (STD), the asynchron- 

ous terminals (ATD), or the bSc's (BSC)? 


Respond with the device type or class that 


NOTE: Type COMM to enter the dialog at 
the question "Does this system have any 
communications type devices?" ‘Then type 
VIP, H3270, PVE, STD, ATD, or BSC to 
enter the dialog at a more specific 
point. 


cer 


cO=tcd) 


} 
) 


Table 4-1 (cont). Rebuild Mode Dialog 


Rebuiid Mode Dialog M4 SYSDEF DIALOG 


Page 
Question Question Response Prompt Reference 


STR SET IIA eI TT aI I TI EE IE TELE 
Do you wish to modify devices -| How many MDC-connected console devices 4-2) 
or system parameters? Respond do you have? 


with "SYSTEM", "DEVICES", "VIEW", 
Or “DONE". How many diskettes do you have? a=22 
How many cartridge disks do you have? 4~-23 


| 


Q 
FE 


DSK 
RCD 


ds 
{ 

ho 

tS 


How many Storage modules do you have? 


nay 
| 

~) 

Ww 


How many cartridge module disks do you 
have? 


hbk 


CDR How many card readers do you have? 
CRP How many card reader/punches or punches 4-25 


do you have? 


How many printers do you have? 4-25 

MTP How many 9-track magnetic tape devices 4-26 
do you have? 

4-30 


Do you wish to modify devices or system 
parameters? Respond with "SYSTEM", 
"DEVICES", "VIEW", or "DONE". 


(No question is asked. This response 
causes the current CLM directive file to 
be listed at your terminal.) 


Would you like to see the generated 
statements? 


EXAMPLES OF M4. SYSDEF eiSLined 


OE CTT NT BRET CAN ATT VT SS OS Te NN AGES eT aS 


The following ayes illustrate how you can first create a 
CLM directive file and then modify it at some later time by 
invoking M4 SYSDEF in rebuild mode. Example 1 steps through the 
entire M4 _SYSDEF dialog. Example 2 illustrates the rebuild mode 
dialog. 


Example 1: 
Following a Stage 1 (initial) system startup, a new user 
wishes to create a CLM file using M4 SYSDEF. Prior to 
invoking M4 SYSDEF, the user must transfer control of the 
operator's terminal from the SS (system) task group to the 
Supplied user task group SH: 

ACASSHs 
The terminal is now under control of the $H task group. The 
user wishes to see the ready prompt message, and so enters 
the RDN (ready on) command: 

RDN 

The system responds: 


(SH) RDY: 


The user invokes M4 SYSDEF and defines a CLM file: 


4-34 CB23-03 


, M4_SYSDEF 

( HELLO} THIS TUOL WILL HELP YOU GENERATE THE FILE CUNTAINING 

: THE CONFIGURATION LUAD MANAGER DIRECTIVES (THE CLMLUSER FILE). 
WHICH IS NECESSARY TO BUILD YOUR GCOS6/MOD400 OPERATING SYSTEM, 
0 YOU WISH TO USE THE LUNG PROMPI] MODE? 


eRe ARE TWO MODES IN WHICH TU RUN THIS TOOL, THE LUNG 

MODE AND THR SHORT MUDE, IF YOU PICK THE LONG MODE, EVERY PROMPT 
MESSAGE WILL Ke PRECEDED BY AN EXPLANATION OF WHAT [TRE REQUESTED 
INFORMATION IS, WHERE YOU CAN FPINU THE REQUESTED INFURMATION, AND 
WHAT WILL HAPPEN JF YOU SUPPLY CEXTAIN INFORMATION, THE SRHURT MODE SHOULD 
BE USED KY RPERSUNS WHU HAVE BUILT THIS SYSTEM pbeFURE AND OU NOT NEED 
THE LONG PROMPT Text, IF YOU SELECT THe SHORT MODE AND THEN FIND 
THAT YOUU NEED KELP IN ANSWERING OVE OF THE QUESTIONS, YUU CAN OBTAIN 
THE LONG MONE TEXT GY ENTERING A '?'3 THIS wItLlL NOT CHANGE THE MOVE 
AND ALL SUBSEQUENT QUESTIONS WILL BE UF THE SHURT FURM, 

SINCE TRIS IS A GENERALIZED TOOL, CERTAIN COMMON DEFAULTS HAVE BEEN 
ASSUMEU;, IF YUUR SYSTEM REQUIRES A CHANGE TO TRESE UEFAULTS, YUU CAN 
GENERATE THe 'CLM_LUSER' FILE AND TREN USE TRE STANDARD EDITUR 

TO MAKE THESE MCOUIFICATIONS, GUCD LUCK, 

DQ YOU wlSH TU USE THe LUNG PRUMPI MODE? 

YES 


THE TUTAL AMOUNT OF REAL, PHYSICAL MEMORY INSTALLEU UN THE MACHINE 
FOR WHICmM THIS SYSTEM JS BEING BUILT MAY BE DIFFERENT FROM 

THE MEMOWY AVATLABLE ON THE MACHINE YOU ARE CURRENTLY USING, 

THE MINIMUM CUNWFIGURATION FUR GCOS6/MOD400 IS '48K!' WORDS. 
WHAT IS The TOTAL AMUUNT (IN WORDS) OF REAL MEMURY UN THE MACHINE THIS 
SYSTEM IS Tu KUN UN? ENTER TRE VALUE IN THE FORMS WNiNK, 

1e8K 


IF YOU wISH, WE CAN GENERATE THE CLM DIRECTIVES WITRUUT SPECIFYING 
THE CHANWEL NUMBERS FUR NONMeCOMMUVICATION TYPE DEVICES, FLIR 
COMMUNICATION DEVICES YOUU MUST ALWAYS PRUVIDE A CHANNEL NUMBER, 

AT SYSTEM STARTe#UP TIME, THE SYSTEM WILL POLL Tete HARDWARE AND 
DETERMINE UPON WHICH CHANNEL EACH DEVICE IS LOUCATEL. 

DO YOU WISh THE SYSTEM TO SUPPLY IRE CHANNEL NUMBERS FUR 
NON*COMMUNICATION DEVICES? 

WO 


ENTER TRE CRANNEL NUMBER OF THE UPERATOR TERMINAL 
WHICH wILlL BE Tre. CONSHLE 


0400 
ENTER THE CHANNEL NUMBER UF THE BUOT DEVICE 
1400 
DO YOU WISH TO BUUT THE FIXED PLAITER? 
NO 
(_ Figure 4-1. Using M4 SYSDEF 
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A COMMERCIAL SYSTEM IS A MODEL 4/ OR MUDEL 57. 
IS THIS A CUMMERCIAL SYSTEM? REPLY "YES" OR "NUL" 
N | 
SINCE YOU OU NOT HAVE A COMMERCIAL SYSTEM, WILL YOU 
HAVE THE COMMERCIAL SIMULATOR 3 IF YOU REPLY 'NU', THEN 
THIS SYSTEM WILL NOT BE ABLE TO SuPPORT COBOL. 
WILL THIS SYSTEM HAVE A COMMERCIAL SIMULATUR? 
y 


SIP MEANS'SCIENTIFIC INSTRUCTION PRUCESSOR', 

WILL THIS SYSTEM HAVE A SIP? REPLY "YES" OR "NU," 

N 

SINCE YOU DU NOT HAVE THE "SCIENTIFIC INSTRUCTIUN PRUCESSUR', WILL YOU 
HAVE THE SIMULATOR FUR THIS HARDWARE UPTION? IF YUU REPLY ‘NUT, THEN 
THIS SYSTEM WILL NOT BE ABLE TO SUPPORT ANY UF THE SCIENTIFIC 
INSTRUCTIUNS, | 

WILL THIS SYSTEM HAVE A SIMULATUR FOR THE SIP? REPLY "YES" GR "NU," 
YES | 

00 YOU WANT ThE DOUBLE PRECISION SIMULATOR SIPSIM? 

NO 


THE SYSTEM IDENTIFICATION IS ONE UF THE STANDARD FARTS UF THE CUMMENT 
STATEMENTS THIS UTILITY AUTOMATICALLY GENERATES, 
IF YOU ENTER A NEw VALUE MAKE SURE JIT IS ENCLOSED wlITHIN 
APOSTROPHE MARKS UR SUME OF THE IVFORMAITIUN MAY BE LUST. 
THE DEFAULT SYSTEM IVENTIFICATION IS 'GCOS6/MDD4UGU', 
IF YOU WISH TU CHANGE IT, REPLY 'YES'3; [F YUU LDU NUI wIdk TU 
CHANGE IT, REPLY 'NU', OU YOU? 
Y 
ENTER THE NEW SYSTEM JDENTIFICATIUN (30 CHARACTERS UR Ltod) IN THE FURM? 
'SYSTEM_IDEWTIFICATION! © 
'"GCOS6/MUD 400 VERSION 2,1! 


THE INSTALLATION JDENTIFICATION 15 UNE UF THE STANUVARD PARIS UF THE 
COMMENT STATEMENTS THIS UTILITY AUTOMATICALLY GENERATES, 

IF YOU ENTER A NEW VALUE, MAKE SURE IT IS ENCLOSED 

NAITHIN APOSTRUPHr MARKS Ok SOME OF THE [NFORMATIUN MAY dE LUST. 
THE DEFAULT INSTALLATION JUENTIFILCATIIN IS '¥GurR TUAN, USAT, 

IF YOU wISH TO CHANGE IT, REPLY 'YES's JF YOU Lil NUIT wlSrh 10 
CHANGE IT, REPLY 'NOU',. DO YOU? 

YES 

ENTER TRE New INSTALLATION IDENTIFICATIUN (80 CHARACTERS Uk LESS) 
IN THE FORMS 'TINSTALLATIOUN IO! 

"TEST SITE UNE! 


THE NUMBER QF CUNCURRENT USERS ASSISTS IN THE CALCULATION UF SYSTEM 
STRUCTURE SIZES AND MEMORY NEEDS WHICH VARY VEPENDING 
UPON THE MAXIMUM LUAD THE SYSTEM 15 TO BE CUNFIGURED 
FOR, THERE IS, HUWEVERK, NY WAY TU ENSURE THAT Tre MAXIMUM 
NUMBER OF USERS THAT YUU SPECIFY HERE WILL INDERD 


Figure 4-1 (cont). Using M4 SYSDEF 
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ee 2 BE THE MAX, NUMBER OF USERS THE SYSTEM WILL SUPPURT. THIS DEPENDS 
( ON SUCR DYWAMIC VARIABLES AS THE WORK EACH USER IS PERFURMING, AND 
MEMORY FRAGMENTALTTIUN, 
PLEASE ENTER THE MAXIMUM NUMBER OF CUNCURRENT USERS THAT YUU 
FXPECT THIS SYSTEM TQ SUPPORT, 
es) 


EVERY PERLFPHERAL DEVICE ATTACHED TU THIS SYSTEM MUST HAVE A 

SPD (SYMBOLIC PERIPHERAL DEVICE) NAME, THIS NAME Id A 

UNIQUE 6 CHAWAaACTER (MAXIMUM) NAME WHICK CONFORMS TO Tre FILE SYSTEM 
NAMING CUNSVENTIONS. IF YOU REPLY 'YES' HERE, 1 WILL GENERATE THESE 
NAMES FOR YOU wITRHULUT ANY FURTRER PROMPTS, IF YUU REPLY ‘Nut, I WILL 
ASK YOU TU SUPPLY THE SPD NAME FOR EACH AND EVERY DEVICE AS We 
CONFIGURE THAT OrVICe 

SHOULO [ AUIUMATICALLY GENERATE Trt SPD NAMES FUR YUU? 

Y 


RECORD LUCKING LS THE FINEST GRANULARITY GF CUNCURKENCY CUNTROL THAT 

DATA MANAGEMENT PRUVIDES. ACTIVAITION OF THIS KUN@TIME UPTIUN PROVIVES 
TOOLS 1H ALLOW MikE THAN ONE USER TO wRITE RECURDS TU A GIVEN FILE AT 

THE SAME TIME, PRUPER USAGE OF THIS OPTION INSURES THAT ALL UPDATES 

ARE CORRECTLY APPLIED TO THE FILE. IF YUU REPLY "Yeo", THIS UPTIUN WILL 
FILE Level CONCURRENCY, L.E, ONLY UNE USER WITH WRITE PERMISSION TO A FILE, 
NO YOU wISH THIS SYSTEM TO ACTIVAIE THE RECURD LUCKING FEATURE UF 
DATA MANAGEMENT? 

YES 


IF YOu Arce PLANWIWG TU USE THe DISPLAY FURMATTING AND CONTROL 
SOFTWARE we NEED TU KNGUN SO IT Cav BE INCLUDED Liv TRE SYSTEM, 
NO YOu &1Se# TU TVCLUDE DISPLAY FURMATTING AND CUNTRUL SUF IAWARE? 
YES 


NO YOu wWwlstt Tu ACTIVATE TRE POWER FAIL RESTART? 
YES 


DOES THIS SYSTEM HAVE ANY CUMMUNICATIUNS TYPE UEVICES? 

lLetee VIPSs TIVSe €1C4 

YES 
EVERY vevVICeE MUST BE ASSIGNED TO A HARDWARE INTERRUPT Level, 

WE AILL PICK THE ABSOLUTE VALUE FUR ALL DEVICES, SINCE THEY MUST 
(ANI TH ONE EXCEPTIUN) BE UNIQUE. CUMMUVICATIUNS DEVICES, RUWEVER, 
MAY SHARE HARNWARE LEVELS AND THUds TO FACILIIATE Tht ASSIGNMENT 
YOU MUST PRIVIDE A RELATIVE LEVEL FOR EACH CUMMUNICATION VevIce 
CONFIGUWED. THE ANSWER TOU THE NEXT QUESTION WILL 
SET UP Tete SWANGE OF LEVELS YOU wIoH Tt) HAVE. THe ACCEPTABLE VALUES 
ARtn: 1,2,5,4, IF YUU SPECIFY 1, 'HEN ALL COMMUNICATION DEVICES 
WILL BE UN THE SAME HARDWARE LEVEL. IF YOU SPECIFY 3S, JHEN YOU 
WILL HAVE THE OPPURTUNITY TO SPREGU THE COMMURILCATIUN DEVICES 
OVER 3 SePARATE LEVELS (1, @, 3), WITH TROSE OtEVICES ON LEVEL 


( Figure 4-1 (cont). Using M4 SYSDEF 
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1 HAVING THe HIGHEST PRIORITY AND THOSE ON LEVEL 3 THE LOWEST. 
HOW MANY COMMUNICATION PRIURITY LEVELS (1 TO 4) DO YUU WISH? 
oo THE NUMBER UF LEVELS, 


ALL COMMUNICATION TYPE DEVICES MUST BE ATTACHED TO A MULTI*LINE 
COMMUNICATIUNS PRUCESSOR (MLCP), 

HOW MANY MLCPS (1 TO 10) WILL THIS SYSTEM HAVE? 

4 


WE ARE REAULY TO CUNFIGURE ANY MLUP CONNECTED ASYNCHRUNUUS TERMINAL 
DEVICES (ATO) THAT YOU HAVE, THESE INCLUDE THE /evG RUN IN TELEPRINTER 
MODE ANU ALL OTHER ATOS, IF YOU OU NOT HAVE ANY UF THESE UVEVICES TU 
CONFIGURE REPLY "NONE" TO THE FOLLOWING QUESTIUN, 

HOW MANY ATUS DO YUU HAVE? 
2 


ATD TERMINAL NUMBER j 
YOU NEEN TO PROVILVE THE BUS CHANNEL NUMBER TO wHICH TRIS VEVICE 
HAS BEEN ATTACKED, THE CHANNEL NUMBER [5 A UNIQUE FUUR CHARACTER 
HEXADECIMAL VALUE WHICH ENDS wITH EITHER "00" UR "BU", 
YOU MUST ENWTER EXACTLY FUUR CHARACTERS, 
WHAT CHANNEL NUMGER WILL THIS DEVICE BE ON? 
FOD80 
ENTER THe CUMMUNICATIUNS PRIORITY LEVEL FUR THIS TERMINAL 
e 
NEVICE TYPES SUPPURTED HY THE Be NEW RONGUS TERMINAL VEVICE DRIVER INCLUDE 
TTY. TAU, 7801, D7200 AND PRU, 
NHAT IS THE DEVICE TYPE FOR THIS aTO DEVICE? 


Evy 
ATD TERMINAL NUMBER e 
WHAT CHANNEL NUMHCER WILL THIS DEVICE BE ON? 
See THE CUMMUNICATIUNS PRIORITY LEVEL FUR THIS TekMINAL 
away IS THe DEVICe TYPE FuR THIS ATO DEVICE? 
7801 


NE ARE NOW READY TO CONFIGURE THE VIP7700S OR VIP76U4S WHICH 

ARE TO BE RUN IN VIP7700 EMULATION MODE. IF YUU DU NUT HAVE ANY 
VIPS TO CUNFIGURE, REPLY 'NONE!' TU THE FOLLUWING QUESTION, 

HOW MANY VIPS DU YOU HAVE? 

5 


VIP TERMINAL WUMSER 1 
WHAT CHANNEL NUMBER WILL THIS OEVICE BE ON? 
FEOO 
HOW MANY VIPS ARE POLLED ON THIS CRANNEL? 
0 


Figure 4-1 (cont). Using M4 SYSDEF 
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Me 
a 


ee 


A, 


ENTER ThE CUMMUNICATIONS PRIORITY LEVEL FOR THIS TERMINAL 

é 

IS THIS VIr A 'CUNTROL STATIUN!? 

YES 

DOES THIS VIP HAVE A RUP (RECEIVE UNLY PRINTER) ? 

YES 

THERE ARE 5 TYPES Ur RUPS TTYS$3, ITY85, TNIO0, TNSOU, AND TNIeVUU, 
WHAT TYPE WF ROP DU YUU hAaVe? | 


TNL 200 
DOES THIS KURF SUPPURT FURM FEED? 
YES 
VIP TERMINAL NUMBER e 
NHAT CaANK CEL NUMpER WILL THIS DEVICE RE ON? 
FFBO 
HOW MANY vIPdS Ake PULLED UN THIS CHANNEL? 
NONE | 


ENTER THE CURMUNICATIUNS PRIURITY LEVEL FOR THIS TeERMIWAL 
3 

IS TRIS VIP A PCUNTRUL STATIUN! ? 

Ny 

DOES THIS vIP HAveE A RUP (wECEIVE UNLY PRINTER) ¢ 

N 


VIP TeRMIivalL NUS KER 3 
WHAT CHAVNEL WUMBER WILL THIS DEVICE BE ON? 
FE OO 
49W MAWwY vIiPS ARE PULLEW) JN THIS CHANNEL? 
1 
ENTER FRE ClimMUNICATIUNS PRKITORITY LEVEL FUR THIS TERMINAL 
e 
ENTER TRE PULLING ADDRESS FOR THI> yvIPp 
le 
DOES THIS vIP HAVE A RUP (RECEIVE UNLY PRINTER) ? 
NO 


AE ARE NOW READY TO CUNFIGURE THE 48270 HUST LINKS AHICH Ake TH 

BE RUN BY Tr—t &BSC LINE PROTOCUL HANDLER, IF YUU DUO WUT HAVE ANY 
H3$270 RUST LINKS TI) CONFIGURE, REPLY NUNE TU THe FULLUWING JuUESTIUA, 
HOW MAWY HS$270 KUST LINKS voll YOU WAVE? 

e 


RS$e70 LIiwe wuMeerR } 
WHAT CHANKEL RUMBMER WILLE THIS LINe BE UN? 
‘ 


YOU NEED Tu PRUVIUE Tre BUS CHANNEL NUMBER TO WHICh TRIS DEVICE 
HAS BEN ATTACHED. THRE CRANNEL NUMBER [TS A UNTQURE FUUR CHARACTER 
HEXADECIMAL VALUE WHICKR tNDS WITR EITHER "QO" UR "BU", 

YOU MUST RNITER EXACTLY FOUR CHARALTERS,. 


Figure 4-1 (cont). Using M4 SYSDEF 
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WHAT CHANNEL NUMBER WILL THIS LINt BE UN? an 

ee TRE CUMMUNICATIONS PRIORITY LeveL FOR THIS LINE 

ice THE PULLING ADDRESS (DECIMAL) FUR THIS HS270 HUST LINK 

ENTER THE SELECT AUDDRESS (DECIMAL) FOR THIS HSe7U HUST LINK 
4 


H3270 LIWwe NUMBER e 

WHAT CHANNEL NUMBER WILL THIS LINk BE ON? 

F800 

ENTER THE CUMMUNICATIUNS PRIORITY LEVEL FUR THIS Lie 
3 


ENTER THE PULLING ADDRESS (DECIMAL) File THIS HS270 HUST LINA 
124 

ENTER THE SeLECT ADDRESS (DECIMAL) FUR THIS H4e70 RUST LINK 
235 


WE ARE NOW READY 10 CUNFIGURE THE POLLED VIF EauULATUR (rvb) GrubeS 

(A PVE GRUUP CONSISTS JF all THE PVE STalluns ASSTG%NE0N TO Tre Same 
HARDWARE CHANNEL). Ik Yul) OU NUT HAVE awY PVE STATIUNS TU CuNe LouRe, 
REPLY "NUNE”" TO TRE FOLLUWING GUEDOTIUN, 

HOW MANY PVE GROURS DU YUU MAVE? 

2 


PVE GROUP NUMBER l 
ENTER CHANNEL NUMBER FOR PVE GRUUP j 
F909 
HOW MANY PVE STATIUNS Art THERE ON TAIS CHANWEL ? 
e 
ENTER THE COMMUNIJCATLUOWS PRIORITY LEVEL FUR THIS urkUUF 
2 
ENTER THE FULLING ADORESS (0 TO S31) FUR PVE STATION 1 
1 
ENTER THE PULLIND ADDRESS (0 TU $1) FOR PVE STATIUN rad 
e 


PVE GRUUP NUMBER 2 
ENTER CeANWwWEL NUMBER FUR PVE GRUUP 2 
F980 
HOW MANY PvE STATIUNS Anke THERE Uv TRIS CHANNEL? 
5 
ENTER THE CUMMUNICATIUONS PRIORITY LEVEL FllR TRIS GkUUF 
} 
ENTER THE PULLING ANDRESS (0 TO 31) FUR PVE STATIUN 5 
\ 
ENTER THe POLL IN ANDRESS (0 TU $1) FOR PVE STATLUN 4 
e 


Figure 4-1 (cont). Using M4 SYSDEF WoL 
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= 


a ENTER THE PULLING ADDRESS (0 TO $1) FOR PVE STATION 5 
5 


WE ARE NOW READY [U CONFIGURE THE SYNCHRUNOUS TERMINAL DEVICE (STD) 
GROUPS (4 STD GkUUP CUNSISTS UF ALL THe STO STATIUNS ASSIGNED TU THE 
SAME HARDWARE CHANNEL), THE PULLING SEQUENCE WITHIN A GRUUP LS 
DETERMINED RY THe URDER ENTERED, 

IF YOU OU NUT HAVE ANY STO STATIUNS TO CUNFIGURE, 

REPLY "NONE" TO TRE FULLUWING QUESTION, 

HOW MANY STD GRUUPS UU YUU HAVE? 

e 


STD GROUP NUMBER ] 
ENTER CRANWEL NUMBER FUR STD bRUUP } 
F680 
ENTER THE CUMMUNICATIONS PRIORITY LEVEL FUR THIS GRUUP 
3 
HOW MANY STUD STAIIUNS ARE THERE Ov TRIS CHANNEL? 
e 
ENTER THE PULLING ADDRESS (0 TO 31) FUR STO STATILUI l 
23 
QOEVICE TYPES SUPPURTED BY THE SYNCHRONGUS TERMINAL UtVICE DRIVER 
INCLUDE V7B80G, YVI7TU0 AND V7760 
WHAT JS TeE VEVICe TYPE FOR THIS oTD DEVICE? 
V7804 
DOES THIS STD RAVE A RUP (RECEIVE UnbLY PRINTER) ? 
YES | 
THERE ARE G&G TYPES UF RUPS ROSY2U, kKUSY2b5, TINS0U, AWD TNIECUU, 


WHAT TYPE UF FUP DU YUU HAVE? 

TN S00 

ENTER Tritt PULLIN AUDRESS (0 TU $31) FUR STO STATION e 
o4 

WHAT IS THE DEVI]Ce TYh—e FOR THIS STO DEVICE? 

V7804 

DOES TRIS STO HAVE A ROP (RECEIVE UNLY PRINTER) ? 

Y 

WHAT TYPrk WF kKUP UU YUU RAVE? 

TNS00 


STO GRUUP NUMBER e 
ENTER CHAWNEL Nilitoew FUR SID GkOUF e 
F600 
ENTER THE CUMMUNICATLUNS PRIURITY LEVEL FOR TRIS GRUUF 
4 
HOW MANY STU STATIUNS ARE THERE Uv THIS CHANNEL? 
3 
ENTER THe PULLING ADURESS (0 TO $1) Ftik STD STATIUN S 
23 
WHAT ITS THk ODOEVICRK TYPE FUR TRIS ofp nevice? 


Figure 4-1 (cont). Using M4 SYSDEF 
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V7700 


DOES THIS ST) HAVE A RUP (RECEIVE UNLY PRINTER) ? —_ 
YES -- | Sia 
WHAT TYPE OF ROP DU YOU HAVE? : 

™N1200 

ENTER THE PULLING ADDRESS (0 TU 31) FUR STD STATION 4 

24 | | 

WHAT IS THE DEVICE TYPE FOR THIS STO DEVICE? 

V7700 | 

DOES THIS STD HAVE A RUP (RECEIVE UNLY PRINTER)? 

NO 

ENTER THE PULLING ADDRESS (0 TO $1) FOR STO STATIUN 5 

25 

WHAT IS THE DEVICE TYPE FOR THIS STD DEVICE? 

V7700 

DUES THIS STD HAVE & RUP (RECEIVE UNLY PRINTER) # 

YES 

WHAT TYPE OF RKOP UU YOU RAVE? 

™N1200 


HOW MANY MLCOP CONNECTED BINARY SYVCHRONQUS CUMMUNICATLUNS (650) LINES 
VO YOU HAVE? 


2 

BSC LINE NUMBER 1 

WHAT CRAANWEL NUMBER WILL THIS DEVICE BE UN? 
F000 


ENTER THe CUMMUNICATIUNS PRIORITY LEVEL FUR IHIS TERMIWAL 
1 
IS THIS BSC LINE A "PRIMARY! UNE? 


YES 
BSC LINE NUMBER 2 

WHAT CHANNEL NUMBER WILL THIS DEVICE BE ONY 

Eunee THE CUMMUNICATIUNS PRIURITY LEVEL FUR THIS TERMINAL 
i THIS BSC LINE A 'PRKIMARY'! ' UNE? 

N 


WE ARE NUW READY TU CuNFIGURE ALL MDC CUNNECTEU CUNSULE UEVILES. 
THESE CUNSOLe DEVICES ARE ALL HANULED 8Y THe CUNSULE DEVICE 
DRIVER (CUN), IF YUU DU NOT HAVE ANY TO CUNFIGURE, REPLY 

"NONE" TO THE FOLLOWING QUESTION, 

HOW MANY MOC CONNECTEO CUNSOLE OEVICES DU YUU HAVE? 

e 


CON NUMBER 1 
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( WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 
0400 
DEVICE TYPES SUPPURTED BY THE CONSULE DEVICE DRIVER INCLUDE 
KSR, 7209, 7601, O720U AND PRU, 
WHAT IS THE DEVICE TYPE FUR THE UPERATUR'S CONSOLE? 
KSR : 


CON NUMBER e 

AHAT CHANNEL NUMBER WILL TRIS DEVICE BE ON? 
048) 

WHAT IS THE DEVICE TYPE FOR THIS CON DEVICE: 
7801 


enw 


WE ARE NOW READY TU CONFIGURE ALL# DISKETTE DEVICES. IF 
YOU 00 NOT HAVE ANY DISKETTE DEVILES, REPLY 'NUNE' TO THe 
FOLLOWING QUESTIUN, 

HOW MANY DISKETTES DUO YOU HAVE? 


qQ 

DISKETTE NUMBER l 

WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 
0500 

DISKETTE WUMRER e 
WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 
0580 

DISKETTE NUMBER $ 
WHAT CHANNEL NUMBER WILL THIS DEVICE KE UN? 
1200 

DISKETTE NUMBER a) 
WHAT CHAWNEL NUMBER WILL THIS DEVICE BE UN? 
1280 


WE ARE NOW REANY TO CONFIGURE ALL CARTRIUGE NISK 

DEVICES. IF YOU VU NOT HAVE ANY TU CUNFIGURE, KEPLY ‘'NUNE' TU THE 
FOLLOWING QUESTIUN,. 
HOW MANY CARTRIOGE DISKS NO YUU HAVE? 


e 
CARTRIDGE DISK NUMBER 1 
WHAT CHANNEL NUMHER WILL THIS DEVICE BRE ON? 
1400 
DOES THIS C4kTRIUVGE DISA NAVE A FIXED PLATTER? 
YES 
CARTRIDGE DISK WUMBER e 
WHAT CHANNEL NUMBER WILL THIS DEVICE Be UN? 
1480 
( Figure 4-1 (cont). Using M4 SYSDEF 
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DOES THIS CARTRIUGE DISK HAVE A FIXED PLATTER? 
NO 


WE ARE NOW READY TO CONFIGURE ALL CARTRIDGE MOUDULE DISK 

DEVICES. IF YOU DU NOT HAVE ANY TU CONFIGURE, REPLY 'NONE' TU THe 
FOLLOWING QUESTIUN, 

HOW MANY CARTRIDGE MODULE DISKS DU YOU WAVE? 

2 


CARTRIDGE MODULE DISK NUMBER } 
WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 
1500 


CARTRIDGE MODULE DISK NUMBER 2 
WHAT CHANNEL NUMBER WILL THIS DEVICE BE UN? 
1580 | 


WE ARE NUW READY TU CONFIGURE ALL STURAGE MODULE 
DEVICES. IF YOU UU NUT HAVE ANY TU CUNFIGURE, REPLY 'NUNE' TU THe 
FOLLOWING WUESTIUN, 
HOW MAWY STURSGE MODULES DU YOU HAVE? 


e 

STORAGE MODULE NUMBER 1 
WHAT CHANNEL NUMBER WILL THIS DEVICk He ON? 
1800 

STORAGE MUDULE NUMBER 2 
WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 
1880 


WE ARE NUW READY TO CUNFIGURE CARD READER DevilteS. IF Yuu 
DO NOT HAVE ANY TU CUNFIGURE, REPLY 'IUNE' TU TRE FULLUWING WUESTIUN,. 
HOW MANY CARD READERS DO YUU HAVE? 

2 


CARD READER NUMBER 1 
WHAT CHANNEL NUMBER WILL THIS DEVICE BE UN? 
2200 


CARD READER NUMRER 2 

WHAT CHANNEL NUMRER WILL THIS OEVICE BE UN? 

YES 

INVALID CHANNEL NUMBERS MUST BE EXACTLY 4 CRARKACTEKS LUNs 
WHAT CHANNEL NUMBER WILL THIS OEVICE Be UN? 

2280 


WE ARE NOW READY TU CUNFIGURE CARD PUNCH AND READER/SPUNCHK DEVICES, 
NOTE THAT THIS JS EITRER A CARD ReADER/PUNCH Ok A CARD PUNCH, 
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ao, 


IF YOU NO NOT HAVE ANY TO CONFIGURE, REPLY 

"NONE" TO THE FOLLUWING GUESTION, 

HOW MANY CARD READER/PUNCHES OR PUNCHES DU YOU HAVE? 
NO 


WE ARte NUW READY TO CUNFIGURE ALL PRINTER DEVICES. JF YOU DU NOT 
HAVE ANY TO CUNFIGURE, REPLY ‘NONE! TO TRE FULLUWING NUESTIUN, 
HOW MANY PRINTERS DU YUU HAVE? 

1 


PRINTER NUMBER 1 
WHAT CHANNEL NUMBER WILL TRIS DEVICE BE ON? 
1780 


We ARE NOW READY TU CUNFIGURE ALL 9*TWwACK MAGNETIC TAPE DEVICES, 
IF YOU DU NOT HAVE ANY TU CONFIGURE, REPLY 'NUNE' TU THE FULLOWING 
QUESTION, 

HOW MANY 9eTRACK MAGNETIC TAPE DEVICES vO YUU HAVE? 


e 

MAGNETIC TAPE DEVICE NUMBER 1 

WHAT CHANNEL NUMHER WILL THIS DEVICE Be ON? 
1700 

MAGNETIC TAPE MNEVICE NUMBER e 

WHAT CHANNEL NUMBER WILL TRIS DEVICE RE ON? 
1900 


ITF YOU WISH YUU MAY UPTIMIZE ALL FUNCTIONS FOR THE GREATEST 
POSSIBLE SPEED, SUT AT THE EXPENSt UF HAVING A LARGE RESIVENT SYSTEM, 
DO YOU WISH TO HAVE ALL SYSTEM UVERLAYS RESIDENT? (YES UR NQ) 
NO 


BY MAKING PARTICULAR UPERATING SYSTEM IwPUT/UUTPUT UVERLAYS PERMANENTLY 
RESIDENT YUU CAN UBTAIN UPTIMUM SPEED Iv SOME CATEGURIES, 

DO YOU WISH TU OPTIMIZE THE READING /SWRITING UF RELAITLVE FILES? 

ay eae WISH TO OPTIMIZE THE READIVG/SWRITING UF RANDUM FILES? 

escent W1SH TO OPTIMIZE Tet READIVG/WRITING OF INDEXED FILES? 

en WISH TO OPTIMIZE RELATIVE FILES wITH VELETABLE RECURDS? 

aa hol WISH TO OPTIMIZE FILE MANAGEMENT UPENZCLUSE FUNCIIUNS? 

ern WISH TO OPTIMIZE THe READING sWRITING UF TAPE FILES? 

00 YOU WISH TU OPTIMIZE e€BCUIC TAFE FUNCTIONS? 

YES 
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DO YOU WISH TD CREATE A BATCH MEMORY POOL? 
YES 

are BIG A BATCH POUL? (NNNNN OR NNK WORDS) 
20 


ENTER THE NUMBER (1 TO 99) OF SYSIEM QVcRLAY AREAS 


YOU DESIRE, 
6 


WOULD YOU LIKe TU SEE THE GENERATED STATEMENTS? 


YES 


*PRODUCED BY INTERACTIve BUILD (VERSIUN 2.0), 


SYS ,,SCIP,06,18,48e.Ek 

DEVICE CON00,0,5,X'U04U00', CONSOLE, 140,,'KSR' 
LOBU CIPSIM 

LOBU SIPSIM_SP 

LOBU ZXPFR 


* "GCOS6/MOD 400 VERSION 2,1','TEST SITE UNE! 


RLOCK 

VOAM 

LOBU ZNVOAM 

COMM 9 

ATD 3,11 ,X'FDBO'.,'HI','TTY! 
DEVICE ATND00,3,11,xX FDS)! 

STTY ATLCOQ RECONNECT YES 

ATD 4,12,xX'FCO0',,'HI','78u4! 
DEVICE ATD01,4,12,X'FCO00! 

STTY ATVOL eRECUNNECT YES 

VIP S,11,X'FFOO', pp eCrO,TNL200,FU 
DEVICE VIPOU,S,11,X'FFOQ! 
DEVICE ROPO0,6,11,X'FFOO' 

VIP 7,1e,X'FF80',++,T 

DEVICE VIPOL,7,12,X'FFAO! 

VIP 8,11 ,-X'FEUO',,1e 

DEVICE vIPOQ2,6,11,X'FEOO' 

H3270 9,11,X'FHB0',,X'7TB',X'EA! 
DEVICE HS5200,9,11,X'F 880! 

HS$270 10eL1,X'FBU0',- X'7C"',X'EB! 
DEVICE H3201,10,11,-X'F800! 

PVE 11,11-+X'F900', ol 

DEVICE PVE0U,11,11>x'F900! 

PVE 12-11,X'F900',-2 

DEVICE PVEO1,12,11,xX'F900' 

PVE 13,10,X'F980'- 41 

DEVICE PVE02,13,10,xX'F980! 

PVE 14,10,X'F980',e2e2 

DEVICE PVE0S,14,1U0,X'F98U! 

PVE 15,10,X'F980',,5 
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LYBU/U9/UN 1145542,5 
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DEVICE 


PVE04,15,10,X'F980' 


STDOLN 12,X'F680' 
STD 16,237,V7A04 


DEVICE 


STO00U,16,12,X'F680! 


ROP TN30U 


DEVICE 


STD01,16,12,X'F6860! 


STO 17,24,,V7804 
DEVICE ST002,17,12,X'FoSU' 
ROP TN300 


DEVICE 


STDOS,17,12e0X'F680! 


POLIST 1 

STAPOL 25,24 
STOLN 15,X'F600! 
STO 18,25,,V7700 


DEVICE 


STD004,16,15,X'F600' 


ROP TN1200 


DEVICE 


ST005,18,15,x'F600! 


STD 19,24,,V7700 


DEVICE 


STD06,19,15¢r'F600! 


STO 20,25,,V7700 


DEVICE 


STDO07,20,15,X'F600' 


ROP TN1200 


DEVICE 
POLIST 
STAPOL 


STD08,20,15—9X'Fo00! 
1 
23,24,25 


BSC 21,10.X"FO00', oP 


DEVICE 


BSC00,21,10,X'FU0U! 


BSC 22,10,X'FU080'. +S 


DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 


BSCOL,22,10,X'F 080! 
CONO1,23,15,X'O4R0! 
DSK00,24,16,X'0500' 
OSK01,25,17,x'0580' 
DSK02,2e6,18,xX' Jeon’ 
0SK03,27,19,x'12e80' 


* DEVICE RCVOON,1,6,x'1400' 


DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE. 
DEVICE 
DEVICE 
DEVICE 


FCD0U,28,6,X'1400! 

RCDO1,29,20-,x%'1480! 
RCMG0,350,21,xk'1500' 
FCM00,51,21,-X'1500' 
RCM01,32,ee/ X'1580' 
FCM01,33,2e,X'1580! 
MSM00,34,25,X%'1400'! 
MSM01,55,24,X'1880'! 
CORU0,36,25,X'e2evun' 
CORO1,37,26,xX'228)! 
LPT0OU,38,27,/X'1780! 
MT900,39,28,xX'1700' 
MT901,40,29,x'1900' 


MEMPOOL S,,/10000-P 
MEMPOOL B,,20480,/P 


Figure 4-1] 


rppeoe 7801! 
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MEMPQOOL 
MEMPOOL 
MEMPOOL 
MEMPQOL 
MEMPQOOL 
MEMPOOL 
MEMPQOL 


pAb,*e,PCU 


070, AB 
oL1,AB 
»Le, AB 
7L3,AR 
7. 4,46 
LS, At 


RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 


MAP >SID>ULM_MAP 


QUIT 


NYUPX 4 
DYWRX 4 
OYROX 4 
OYRWX] 
OZXINV 
OZxSUV 
UZXSUB# 
OYOMR 3 
QCYOMC 

OYUPC 

OZCINYV 
OZCKEY 
OZCLNK 
OZCPSN 
OZCSUs3 
OZUCCH 
H2ZUSUb 
OYOMT 

OZTUTL 
OZIETA 
OZTATE 
QYOMRe 
OYUPN 


00 YOU WANT 


YES 


WOULD YOU LIKe TO USE A FILE NAME UTHER THAN 


YES 


ENTER YOUR FILE 


EXAMPLE A 

CLM FILE NAME JTS3 
“SYSSRM>UDD>SYS_ADMIW>SANBORN>M4Re J >EXAMPLE SA 

RESTART FILE NAME I[S2 
“SYSSRM>UDUASYS_ADMIN>SANBORNOMUKC  LoMaRST 


TO CREATE THE CLM DIRECTIVE FILE NOW? 


NAME 
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CLM_USER FURX THIS FILE? 
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Example 2: 


To modify the CLM directive file created in Figure 4-1, the 
user invokes the M4 SYSDEF program in rebuild mode, sSpecify- 
ing the name of the restart file on the command line. 

Figure 4-2 illustrates the rebuild mode dialog. 


Ma SYSDEF M4RST 1 

Vill! HAVE ENTERED MG SYSOFr TA) THE REBUTEN MUDE, 
No YOu waht TO SFR THE EXISTING CLY STATERENTS? 
VES 


APPURMUCED RY TSTER ACTIVE BUILD CVERSTON 2.0), Mu 1980/09/05 1427°45,5 
SYS ,-/SCTPee,128,44,,F 

New CE CNG, Uy yok ee COW SOLE a 1 Aa ROR 

PRE CTRPSEM 

ort STPSTM. SP 

pryR ul 2 XPRS 

% OCCT Sby7ert Bie VE esis eel PEPPERELL fa," 

RPL(ICK 

haere 

LyRil 7hyp ar 

Coes G 

RRS Sie Ay VERIO 5 ST tg EY 

HEC k BPO S41 eg YR 

STEY aTtigtn MRE CIS ORC T YES 

TR Bape te POU eg Le Tet 

NEIeTCe: ATs ay fey er Coe 

Spel: Nae mr FCO NECT YES 

VTP So ltse PEON py oe leh TTI 

DEVICE VIPOCO,5S,11,XtRF On 

NEVIS er RAPOCU,A,LTI,X TPE OG! 

WER: Pio te pha pyc 
HEUTE VERO eye ea ko EER 
VTP B,liyzxtFFUN',, 12 
NEVICR VIPCC»o,11,% FENN! 

HS27C Geli,px' FAO, X'ITHI,XIERA' 
YEVICE 6 $200,9,11,x'F RRS 

eae. Viele CTE ROU eg oO Ee ES 
DEVICE PSPUTy 10) 1 XT RRO 

PYF Jt,11-¥'FONN'T,, | 

NEVICE PVENO,11,31,% F909! 

PVF 12,11 ,x'FoO0', LA 

NEVTCRE PVF OL, LP, ed TE OI09! 


- 
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PVF 15,10,X'FY98BO',,1 
NEVICE PVEN2,13,10,x'F9RN! 
PVE 14,10,X'F9A0',,2 
NEVICE PVE0S$,14,10,x'FQKO! 
PVE 15,10,X'F9AO',, 


NEVICE 


PVE04,15,10, 


STNLN 12,X'FH80! 
STN 16,23,,V7804 


NEVICE 


STH00,16,1e- 


RNP TN S00 


NEVICE 
STM 17 


STD01,16,19, 


,2e4,,V78N4 


DEVICE STH020,17,1e, 
ROP Th 400 


NEVICE 


S$T00$,17,12, 


POILIST 1 


STAPOL 
STOLS 


25,04 


1S,x'FAGN! 


STi) 14,28,,vV7790 


DEVICE 


STNO94,18,13, 


ROP Tule AG 


DEVICE 


$7) 19, 


STNG5,18,15, 
C4, ,v779A0 


<x tA 


"FQR()! 


X'FRal! 
x'PARO! 
x'FRan! 


x'FRRO! 


X'FRGO! 


x'FAariGt 


NEVICE STN06,19,3%,x' FADE! 


STN 20, 


NEVICE 


CSeeV7T79N0 
STU07,°0,18, 


ROP TNLEOG 


DEVICE 
POLIST 
STAPQOL 


STINH,P0,18, 
1 
23,24,25 


BSC 21,10,x'FuNG',, 


NEVICE 


HSC ee. 


NEVICE 
DEVICE 
JQEVICE 
NEVICE 
JEVICE 
NEVICE 


KSCOG,e1,10, 
1O,xX'FORO',, 
RSCOL,2?,10, 
CAWO1,25,15- 
OSKO0,24%,14, 
USK01,25,17, 
0SK02,26,18, 
O0SK0$,27,19, 


* NEVICeE kC0N0G,1.,6, 


JEVICE 
NEVICE 
NEVICE 
NEVICE 
NEVICE 
DEVICE 
NEVICE 
NEVICE 
NEVICe 
NEVICE 


FCD090,23,6,% 
RCD01,29,°0, 


FCM0O0, 31,21, 


RCMO1, 52,2, 
FCMO1, $3,22, 
MSM00, 34,23, 
MSM01,35,e4, 
CHROO, 5$6,¢5, 
CNRO1,37,26, 


Figure 4-2 (cont). 


x' Fagot 


Xx'FROD! 


tena! 


eo 
ro4uagt 
rosag! 
Prasad! 
xP pean! 
x' grant 
x'yago' 
yang! 

x'yduo! 
Kx'+500! 
¥' 150900! 
¥' 45a! 
x'495a0! 
x'yand! 
K'yRA0' 
x'eegd! 
X'2780' 


2 
x 
») 
K 
x 
X 
x 


peor SAUL! 
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DEVICE LPT00,38,27,x%'1780' 
DEVICE MT900,39,28,x'1700' 
DEVICE MT901,40,29,X'1900! 
MEMPOOL S.--10000,P 

MEMPOOL B,»20480,P 

MEMPOOL ,4B,*,PCU 

MEMPOOL »L0,AB 

MEMPOOL -L1,AB 

MEMPOOL ,»,Le,AB 

MEMPOOL ,L3,A8 

MEMPOOL ,»L4,AB 

MEMPOOL ,»L5S,AB 


RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESULA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 


OYUPX1 
OYWRX 14 
OYROX1 
OYRWX I 
O7XINV 
OZXSOV 
OZxKSuUR 
OYOMRS 
OYOMC 

QOYUPC 

NZCINV 
OZCKEY 
OZCLNK 
O7CPSN 
OZCSuR 
OZUCCA 
OZUSUR 
OYOMT 

OZTUTL 
OZTETA 
OZTATE 
OYDOMRe 
OYOPN 


MAP >STD>CLM_MAP 
QUIT 


NO YOU wISH TO MODTFY NEVICES OR SYSTEM PARAMETERS? 


RESPOND WITH "SYSTEM", "DEVICES", "VIEW", OR "DOWE", 

RESPONSE = 

NEVICES 

RESPOND WITH THE DEVICE TYPE OR CLASS THAT YOU wISH TO MODIFY, 
"COMM", "CON", "DSK", "RCD", "MSM", "CMO", "COR", 

"CRP", "LPT", "MTP, OR "DONE", 

RESPONSE = 

COMM 


D0 YOU WISH: TO MODIFY THE COMMUNICATIONS LEVELS AND THE NUMBER OF 


MLCP'S (COMM), THE VIP'S (VIP), THE HOST LINKS (H3270), THE 
PVES (PVE), THE SYNCHRONOUS TERMINALS (STD), 

THE ASYNCHRONOUS TERMINALS (ATO), OR THE BS8C'S (88C)? 
RESPONSE =z 

COMM 
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NOES THIS SYSTEM HAVE ANY COMMUNICATIONS TYPE DEVICES? | | | ee 
Te.Eer VIPS» TTYS, ETC, > “3 
NO : Nn ee 


NO YOU wISHKH TO MODTFY THE COMMUNICATIONS LEVELS AND THE NUMBER OF. 
MLCOP'S (CMM), THE VIP'S (VIP), THE HOST LINKS (H3270), THE 

PVES (PVE), THE SYNCHRONOUS TERMINALS (STD), | 

THE ASYNCHRONOUS TERMINALS (ATD), OR THE BSC'S (BSC)? 

RESPONSE = 

NONE 


RESPOND wIThR THE DEVICE TYPE OR CLASS THAT YOU wWISK TO MODIFY, 
"COMM", "CON", "DSK", "RCD", "MSM", "CMD", "COR", 

"CRP", ";_ eT", "MTP", OR "NONE", 

RESPONSE = 

NONE 


NO YOU wISH TO MODTFY DEVICES OR SYSTEM PARAMETERS? 
RESPOND WITH "SYSTEM", "NEVICES", "VIEW", OR "DONE", 
RESPONSE = 

SYSTEM 


NO YOU wISH TU MOUTFY THE PROMPT (PROMPT), MEMORY SIZE (MEMURY), THE 
NUMBER OF INTERACTIVE USERS (USERS), THE AUTOMATIC GENERATION OF 

SPD NAMES (SPD),THE AUTOMATIC CHANNEL ASSIGNMENT (CHANNEL), THE ~ 
RECORD LOCKING FEATURE (RLOCK)+ THE SYSTEM OVERLAY AREAS (SOAT), THE 
RESINENT OVERLAYS (RESOLA), THE OISPLAY FORMATTING FEATURE (VDAM), 
THE COMMERCIAL OR SIP SIMULATORS (SIMUL), 

QR THE SYSTEM AND TNSTALLATION INENTIFICATION (IOENT)? 

RESPONSE = 

RESOLA 


IF YOU ,ANISH YOU MAY OPTIMIZE ALL FUNCTIONS FOR THE GREATEST. 
POSSTBLE SPEFOD, BUT AT THE EXPENSE OF HAVING A LARGE RESIDENT SYSTEM, 
NO YOU «TSHR Tu HAVE ALL SYSTEM OVERLAYS RESIDENT? CYES OR NOQ) 

YES 


NO YOU wISH TO MOD TFEY THE PROMPT (PROMPT), MEMORY SIZE (MEMORY), THE 
NUMBER OF INTERACTIVE USERS (CUSERS), THE AUTOMATIC GENERATION OF 

SPD NAMES (SP0D),THE AUTOMATIC CHANNEL ASSIGNMENT (CHANNEL), THE 
RECORD LOCKING FFATURE (RLOCK), THE SYSTEM OVERLAY AREAS (SOAT), THE 
RESIDENT OVERLAYS (RESOLA)» THE DISPLAY FORMATTING FEATURE (VDAM), 
THE COMMERCIAL OR SIP SIMULATORS (SJMUL), 

OR THE SYSTEM AND INSTALLATION IDENTIFICATION (IDENT)? 

RESPONSE = 

NONE 


NO YOU WISH TO 4ODTFY DEVICES OR SYSTEM PARAMETERS? 
RESPOND WITH "SYSTEM", "DEVICES", "VIEW", OR "DONE", 
RESPONSE = . | 

NONE 

WOULN YOU LIKE TO SEE THE GENERATED STATEMENTS? 

YES 
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( 


ePROOUCEN 


SYS ,eSCJIP»6,18,45,,E£ 


NEVICE CNNO0,0,5,K'9O460',CONSMLE,140,,'KSK! 


LDRU CIPSIM_ 
LOBU STPSIM_SP 
LORI) ZXPFR 


* 'GCOSH/4ND 400 VERSION @.1', PEPPERELL 


RLOCK 
VOAM 


LORBU ZNVDAR 


DEVICE 
NEVICE 
NEVICE 
NEVICE 
DEVICE 


CNN0O1,23,15,x'ouao! 
NSKO0,24,16,xX%' OSU! 
OSK01,°5,17,x'oSad'! 
NSKN2,26,)8,x'1200! 
YSK08,27,19,x%'12809' 


* DEVICE RCCOU,1,6,x' 1400! 


NEVICE 
NEVICE 
DEVTCE 
NEVICE 
NEVICE 
NEVICE 
NEVICE 
NEVICE 
NEVICE 
NEVICE 
NEVICE 
NEVICE 
DEVICE 


FCDN0,28,5,X'1400! 

RO001,29,°0,x'14a0! 
RCM00,39,°1,xX'1560! 
FCMN0, $1,P1,x'1500! 
RCM01,32,P2,xX'15AR9! 
FCM01,33,e2,x'15R0! 
MSM4N0,34,°3,x'yaqgon! 
MS5401,35,e04,x%'j 2880! 
COROG, $36,2°5,x' PAON! 
CNRO1,57,eh,x' erat! 
LPT00,38,e7,x'1780'! 
MT900,39,28,x'1700! 
MT901,40,2°9,x'1900' 


RY INTERACTIVE RIILS 


Epp TB! 


(vr RSTON 


1980/09/05 14343 58,5 


MEMPOOL S,pr10U00,P 
MEMPOOL R,»peN4R0,P 
MEMPOQOQOL ,AR,*,PCH! 
MEMPOOL »L0,48 
MEMPQNOL »L1,Ax 
MEMPNQNQOL ryLe,As 
MEMPOOL ,L3,A5 
MEMPOOL .L4,A6 
MEMPOOL ,4L5,4R 
CLMIM RESDLA 

MAP >STO>CL™_mAP 
QAUTT 


NO YOU WANT TO CREATE THE CL OIRECTIVE FILE NOW? 
YES 
WOULD YOU LIKE TO USF A FILE tASF OTHER TRA) CLM_USFR FOR THIS FILE? 
YES 
FNTER YOUR FILE NAME ef 
EXAMPLE TA 
CLM FIJILE NAME TS3 
“SYSSRMPUND>SYS_ANsTN>SARRIRN>OUNN>EXAMPL EFA 
RESTART FILE war TS: 
“SYSSRMPUDI>SYS_ANMITND>SANRIRA DIAN AManST Ce 
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SECTION 5 


BASIC CLM DIRECTIVES 


This section describes the CLM directives used to define the 
basic characteristics of the system. The CLM directives for the 
optional communications environment of the system are described 
in Section 6. If you are a first-time user, you should be 
thoroughly familiar with all the topics discussed at the begin- 
ning of this section before you create your CLM directive file. 


Appropriately coded CLM directives (including those for com- 
munications, if applicable) must be placed in the CLM USER file 
under directory SID on the bootstrap volume before a stage 2 or 
Stage 3 system Startup is performed. (The stages of system 
Startup are described in Section 3.) 


Table 5-1 summarizes the basic CLM directives, which are 
described in alphabetic order later in this section. Briefly, 
these CLM directives define the following aspects of the system: 


e System variables such as power line frequency, scan cycle 
of real-time clock, Scientific and/or Commercial Instruc- 
tion Processor options, number of system overlay areas, 
number of trap save areas, number of intermediate request 
blocks, and expanded error message code option (SYS 
directive) 


e Characteristics and sizes of syStem memory pool, online 
memory pools, and batch memory pool (if any) (MEMPOOL 
directives) 


@e PhySical and logical characteristics of MDC-connected 
peripheral devices (DEVICE directives) 


e System overlays that are to be made permanently resident 
(RESOLA directives) 


e Operating system extensions that are to be made perma- 
nently resident (LDBU directives) 
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e System physical attributes, system structures, device | 
Status, user-defined variables, and memory pool specifica- 
tions (MAP directive) 


e Single character expressions that may be used in certain 
directives instead of constant values (VARIABLE 
directives) 


e User-written device drivers that are to be made perma-— 
nently resident and characteristics of the devices driven 
by them (DRIVER directives) 


Table 5-1. Summary of Basic CLM Directives 


Directive Meaning 


CLMIN Causes subsequent CLM directives to be read from a 
different device/file. 


* (comment) Used to include a comment in the file of CLM 
directives. 


DEVICE Identifies a peripheral device and its character- 
istics, both physical and logical. 


DRIVER Identifies a user-written device driver and one 
device driven by it. 


LDBU Identifies a bound unit (usually user-written) that 
is to be made permanently resident in the system 
area of memory. 


MAP Provides configuration information that allows you 
to verify the success of certain aspects of the 
system building process. 


MEM POOL | Defines the system memory pool, the batch memory 
pool, or one or more online memory pools. 

QUIT Indicates the end of the input file of CLM 
directives. 

RESOLA Identifies one or more system overlays that are to 
be made permanently resident in the system area of 
memory. 

RLOC K Defines a pool of structures to be used by data 
management when record locking is requested. 

SYS Defines a number of system variables. 

VARIABLE | Allows you to define variables for parameters in 


certain CLM directive statements. 
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RULES FOR ARRANGING CLM DIRECTIVES 


( Only a few rules apply to the order of basic directives in 
| the input file read by the Configuration Load Manager. These 
rules are listed below. (Rules governing the order of 
communications-related CLM directives are described near the 

beginning of Section 6.) 


1. Each noncommunications (MDC-connected) peripheral device 
in the system must be identified in a separate DEVICE 
directive. (As described in Section 6, communications 
devices must be identified in DEVICE directives only if 
they are to be accessible through the file system.) 


2. If the operator terminal is connected to an MDC, the 
DEVICE directive for the operator terminal should be the 
first CLM directive. ThiS arrangement allows the opera- 
tor terminal to be available for possible error messages 
related to subsequent CLM directives. 


3. If your configuration requires more than the default 
number of trap save areas (7) and/or more than the 
default number of intermediate request blocks (20), a SYS 
directive with appropriate tsa and irb argument values 
Should be placed as close as possible to the beginning of 
the file of CLM directives. The additional trap save 

— areas and/or intermediate request blocks are available as 
{ soon as the SYS directive is read. 


4. If the CLMIN directive is used, it must not precede the 
DEVICE directive that identifies the device implied by 
the pathname argument of the CLMIN directive. 


5. If LDBU directives are used to identify both a SIP Sim- 
ulator and a Commercial Simulator, the Simulator identi- 
fied in the latter LDBU directive will be the first to 
process a trap to the trap vector shared by the two 
Simulators. 


6. A variable must be defined by a VARIABLE directive in the 
CLM file before it can be used in subsequent directives. 


7. QUIT must be the last CLM directive in the input file. 
Any directives that follow QUIT wil not be processed. 
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FORMAT OF CLM DIRECTIVES 


A CLM directive consists of a string of up to 72 ASCII 
characters. The format of a CLM directive is shown below: 


mnemonic argument 1[,argument 2][,argument_3]...[,argument_n] 


In the directive descriptions in this section and in 
Section 6, the following conventions apply: 


Le 


2. 


The directive mnemonic is shown in uppercase. It must be 
specified exactly as shown. ) 


Exactly one space must separate the directive mnemonic 
from the first argument. | 


In arguments, lowercase words and letters indicate values 
that must be specified by the user. | 


Arguments within square brackets [] are optional. 


Vertically stacked arguments within braces {} represent 
options, one of which must be chosen when the argument is 
used. 


Arguments in a directive are separated by commas. 
Embedded blanks are not allowed within arguments. Blanks 
are not allowed between arguments. 


A blank terminates the list of arguments in a directive. 
Anything following this blank is considered a comment. 


All arguments are positional, meaning that they must be 
Specified in the order shown in the directive descrip- 
tion. If a given argument is omitted and a following 
argument is used, the omitted argument must be signified 
by delimiting commas (e.g., DEVICE LPT02,15,22, 
X'1380',,,N). 


Trailing commas are not required after the last argument. 
Continuation lines are not allowed. 

Unless stated otherwise, unSigned positive integers less 
than or equal to 65,535, (FFFF,, ) can be expressed in 
decimal or hexadecimal. 


If a value exceeds 65,535, , it must be expressed in 
double-word hexadecimal format (i.e., D'hhhhhhhh'). 


A decimal integer consists of one or more decimal digits 
(e.g., 1234). 
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A hexadecimal channel number consists of the constant 
"xX" followed by four hexadecimal digits expressed in the 
format: X'h...' (e.g., X'FF80'). 


12. If an ASCII character string begins with a decimal digit, 
the string must be enclosed within apostrophes (e.g., 
a We ae 


13. The line length specified for a terminal or other input 
device at system building time overrides the command pro- 
cessor line length of 127 characters. For example, at a 
terminal configured with a line length of 80 characters, 
you cannot enter a continuous command line longer than 80 
characters unless you type an ampersand (&) at the end of 
the line and then continue on one or more additional 
lines. You can alter the terminal's line length by using 
the set terminal characteristics (STTY) command (de- 
scribed in the Commands manual) after system initializa- 
tion or by modifying the STTY directive in your CLM file. 


14. For each noncommunications device configured, you have 
the option of specifying a channel number or allowing the 
System to dynamically assign or "float" channel assign- 
ments at startup time.' To float a channel, you specify 
the channel number parameter in the appropriate DEVICE or 
DRIVER directive with a single zero (0). The system then 
asSigns appropriate devices to any available channels. 
Note that if you specify a zero channel and the system 
cannot locate an appropriate device for it, no error mes- 
sage is issued. 


M4 SYSDEF, the interactive CLM directive generation program, 
allows you to float channel numbers for all noncommunications 
devices, if you so choose. See Section 4 for details. 


Channel numbers are assigned according to the order in which 
DEVICE or DRIVER directives with zero (0) channels are specified 
in the CLM file. To prevent devices with zero channels from 
inadvertently preempting devices whose channel numbers are 
explicitly specified, all devices of a given type with explicitly 
specified channel numbers should precede all devices of that type 
with zero channels in the CLM file. 


For noncommunications devices, the first available device 
having the lowest bus address and the correct dévice identifica- 
tion is assigned to the first available MDC-connected DEVICE or 
DRIVER directive encountered in the CLM file, and So on. 


1By assigning floating channel numbers to devices in the CLM 
file, the system builder need not know the channel numbers at 
each installation that will receive a copy of the system 
software. 
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If a system is configured: with devices containing zero chan- 
nel numbers, you may determine all channel numbers assigned by 
the system after system initialization. The system operator can 
issue the command STS -ALL to list each device and its channel 
number assignment. 


Specifying a DEVICE KSR directive with a zero channel number 
causes the system to search for the first available MDC-connected 
keyboard/typewriter terminal. If none is available, the system 
will assign an MDC-connected CRT/keyboard terminal to the KSR 
driver. Note that the KSR driver is capable of operating only in 
command mode and Single character mode. 


Specifying a DEVICE CON directive with a zero channel number 


causes the system to search for the first available MDC-connected 


CRT/keyboard terminal. If none is available, the system assigns 
an MDC-connected keyboard/typewriter terminal to the CON driver, 
but only if the “terminal-type" parameter (the eighth parameter 

in the DEVICE directive) is specified aS KSR or TTY. Note that 

the CON driver operates in field and command modes only. 


The system identifies the presence of a device adapter and 
assumes that the corresponding channel numbers are valid and 
usable. In such a case, the system may asSociate an unusable 
channel with a physical device. If no device is available to 
Satisfy the directive, the user is not informed. If a system 
includes device adapters but not associated devices, then 
explicit channel numbers should be assigned to all devices within 
the device class. 


PRELIMINARY CONSIDERATIONS 


The following paragraphs describe: 


e How to incorporate overlays and user-written bound units 
into your configuration 


@ enone allocation and usage 

e Performance considerations 

e How to Menu your peripheral devices 
e How to configure the operator terminal 
e File system pathnames in CLM directives 


You should review each of these topics before you create your CLM 
directive file. 
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System Overlays 


( Within the system software, many system functions are imple- 
mented as overlays. Each system overlay runs in a 512-word sys- 
tem overlay area in the system area of memory. By default, one 
512-word system overlay area is created. If you wish, you may 
use the olan argument of the SYS directive to create additional 
512-word system overlay areas (up to a maximum of 99) so that 
multiple system overlays can be co-resident at any time. In this 
case, the system will not be forced to repeatedly change the con- 
tents of the single system overlay area aS various system overlay 
functions are required. 


In addition to, or instead of creating multiple system over- 
lay areaS, you may wish to make certain frequently used system 
overlays permanently resident in the system area of memory 
(increasing its size at the expense of memory available for user 
tasks). This can be done by means of the RESOLA directive. Each 
RESOLA directive allows specification of one or more system over- 
lays, each of which is loaded for permanent residency during sys- 
tem startup. The names and approximate sizes of all system over- 
lays are listed in Appendix B. 


System Extensions 


A system extensSion is an optional, uSer-written or system- 
oe supplied bound unit (consisting of re-entrant code) that is iden- 
( | tified in an LDBU directive and loaded, for permanent residency 
in the system area of memory, during system configuration.’ Mul- 
tiple system extensions can be used. 


System extensSions are most efficient when they are more or 
less continuously used through symbolic references from multiple 
application task groups and this usage does not permit a possible 
delay in the initial loading of the extension. 


System extensions may be used to define system-wide global 
address symbols. These symbols must have been defined in EDEF 
Linker directives as each extension bound unit was linked. 

Later, as the bound unit is loaded during system configuration 
(by virtue of the LDBU directive), the system-wide global address 
symbols are added to the system symbol table, where they can be 
used (by the system loader) to resolve any unresolved references 
to them occurring in subsequently loaded bound units. 


Any dynamic requests for memory originating from a perma- 


nently resident system extension are fulfilled from the memory 
pool of the task group that is uSing the extension. 


sas 1The SYS Linker directive must be used when the system extension 
; is linked. 
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Note that if system extension code is not concurrently used 
by multiple applications, it can be individually linked into 
applicabie uSer-written bound units and not loaded for permanent 
residency at system startup. In this case, an LDBU directive is 
not used, and the extenSion will reside in memory only as part of 
each user-written bound unit with which it has been linked. 
Appropriate symbols in system extensions used in this way can be 
identified in XDEF Assembler control statements and thus resolved 
at link time. 


Memory Allocation and Usage 


system startup allowsS main memory to be divided into the 
following areas (aS a maximum): 


e system area 
e System memory pool 
@e Online memory pools 


- Exclusive 
- Nonexclusive 


e Batch memory pool 


The system area contains resident system software, one or 
more system overlay areas ‘(as specified by the olan argument of 
the SYS directive), any permanently resident system overlays (as 
specified in RESOLA directives), any permanently resident system 
extensions (as specified in LDBU directives), and any user- 
written device drivers (as specified in DRIVER directives). The 
system memory pool, online memory pools, and batch memory pool 
are described in separate MEMPOOL directives (the batch memory 
pool is optional). Each MEMPOOL directive establishes the type 
and size of one or more memory pools. In the case of online 
memory pools, the MEMPOOL directive also establishes (1) the 
2-character identity of each memory pool defined therein and (2) 
whether, for each memory pool defined, additional memory can be 
obtained, as necessary, from the batch memory pool (if any). 


system memory pool, whereas roots of bound units linked as non- 
Sharable are loaded into an online memory pool or into the batch 
memory pool. Each task group iS aSSociated with one and only one 
memory pool, but more than one task group may be associated with 
the same memory pool. See the System Concepts manual for a more 
detailed description of memory pools. 


ACCESS TO MEMORY POOLS 
Following a system startup, all nondisk devices and files are 


initially accessible to task groups in online memory pools and in 
the batch memory pool (if any). The MFA (modify file) command 


can be used (in an online memory pool task group) to make a 
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nondisk device or file inaccessible to the batch memory pool. 
However, when a subsequent system startup is performed, all non- 
disk devices and files are once again accessible to task groups 
in online memory pools and in the batch memory pool (if any). 


FRAGMENTATION 


One memory-related phenomenon, “fragmentation," warrants 
mention here. Fragmentation is the development, within a memory 
pool, of unusable “holes" or "fragments" of memory. It usually 
results from the dynamic acquisition and release of memory within 
a pool by a number of concurrently active tasks. Since the sys- 
tem's memory manager satisfies dynamic requests for memory within 
a pool on a first-come/first-served basis in consecutive mul- 
tiples of 32-word blocks, it is possible that the order of memory 
acquisition and release may create a situation wherein a request 
for memory cannot be satisfied even though sufficient free memory 
exists. 


This situation might occur, for example, when a task has suc- 
cessfully obtained four areas of memory within a pool and the 
pool's free memory is nearly exhausted. If the task released the 
second area (e.g., 128 words) and the fourth area (e.g., 96 
words), the task's subsequent request for 192 words might be un- 
successful because that much consecutive memory is not available 
(even though at least 224 words -- the amount released -- is 
available in two nonconsecutive areas). 


Note that if tasks obtain and release memory on a last- 
obtained/first-released basis, the potential for fragmentation is 
reduced, especially when only a few tasks share a particular 
memory pool. 


The potential for fragmentation increases with the number of 
tasks sharing a memory pool and with these tasks' dynamic use of 
memory. In general, the system memory pool becomes fragmented 
before uSer memory pools do. Calculations for memory pool size 
later in this section include a factor to allow for potential 
fragmentation. 


Performance ConSiderations 


® Systems can be configured on hardware having an MMU with- 
out utilizing the MMU. This is accomplished by use of CLM 
MEMPOOL directives. If no memory pools are protected or 
contained, and no batch pool exists (or an existing batch 
pool is specified as not contained), then the features of 
the MMU cannot be used. 


e Ina given configuration, if any single nonexclusive pool 


has protect and/or contain attributes, all nonexclusive 
pools have the same attributes. 
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e MMU Inrush Overhead 


MMU inrush is defined as the load of MMU by firmware at 
context restore time. 


- If pools other than the system pool are protected and/ 
Or 1£ pools other than the batch pool are contained, 
there will be an MMU inrush each time any task except a 
system task is scheduled. On a system with an MMU, the 
inrush will take 19 microseconds for SAF and 37 micro- 
seconds for LAF. 


- If only the system pool is protected and/or only the 
batch pool is contained, there iS no MMU inrush over- 
head. A Single load of the MMU occurs during system 
initialization and the MMU contents are not changed 
unless the system is reconfigured. (The only exception 
is that the MMU contents are temporarily changed at 
batch rollout.) 


- If the system is configured without protection or con—— 
tainment, there is no inrush overhead. 


- For configurations in which MMU inrushes occur, a data 
Structure of 32 words for SAF (64 words for LAF) 1s 
required for each protected or contained pool and for 
the set of nonprotected noncontained pools. 


Identifying Peripheral Devices 


Each noncommunications (MDC-connected) peripheral device in 
the system must be identified in a separate DEVICE directive. 
The device may be designated as accessible through the file sys- 
tem or accessible only through physical input/output. (AS 
described in Section 6, communications devices must be identified 
in DEVICE directives only if they are to be accessible through 
the file system.) 


The DEVICE directive's arguments specify the characteristics 
of the device: 


Unique device unit identifier 

Priority level number 

Channel number on Megabus 

Unique logical resource number 

Unique device name for file system references 
Maximum record size 

Buffered/unbuffered input/output 


Configuring the Operator Terminal 


The following paragraphs describe characteristics of the 
operator terminal and the various configuration options available 
to you. 
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OPERATOR TERMINAL CHARACTERISTICS 


The operator terminal is the single device designated as the 
control terminal for the system. It must be assigned to Irn 0 at 
system configuration time in order to be identified by the 
system. 


The operator terminal is the only terminal from which commu- 
nication with the system task group $S is possible. Capabilities 
unique to the operator terminal include the creation of the batch 
task group, suspension and reactivation of batch and online task 
groups, peripheral device control, print/punch daemon startup, 
and the monitoring of system status. 


Normally, an operator terminal is configured during a stage 2 
or stage 3 system startup. (An operator terminal is always con- 
figured automatically in a stage 1 system startup.) The operator 
terminal may be a terminal connected to an MDC or a terminal con- 
nected to an MLCP/DLCP. 


CONFIGURATION OPTIONS 


As the system builder, you have three options with respect to 
configuring the operator terminal: 


e You can configure a terminal that will function as the 
operator terminal for the life of the system. 


e You can configure a dual-purpose terminal that can func- 
tion alternately as an operator terminal and as a non- 
operator terminal. | 


e You can choose not to configure an operator terminal. 


You might choose the first option if you wish to always have 
one terminal reserved for the operator's excluSive use. This 
terminal would always have the capability to perform those con- 
trol and administrative functions unique to the operator. Note 
that the operator terminal cannot support forms processing 
software. 


The second configuration option allows you to assign a dual 
function and identity to the operator terminal. You assign two 
unique names to the terminal: a "device name" that identifies 
the terminal when it is functioning aS a non-operator terminal, 
and an “operator terminal name" that identifies the terminal when 
it is functioning as an operator terminal. You might choose this 
configuration option if operator functions will be infrequently 
performed and you wish to free the operator terminal for user 
applications (especially forms processing). The ability to 
perform forms processing will only be available to users when the 
terminal is functioning as a non-operator terminal. 
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Operating procedures for an operator's console configured by 
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The third configuration option does not permit commands and 
procedures unique to the operator terminal to be performed. You 
might choose this option if your system configuration will run 
under a dedicated application. 


Configuring an Operator Terminal to Function for the Life 
of the System 


A device configured to function as the operator terminal for 
the life of the system will always allow users the capability to 
perform those control and administrative functions unique to the 
operator. 


If the permanently assigned operator terminal is connected to 
an MDC, the operator terminal must be identified by a DEVICE 
directive. This DEVICE directive should be first in the CLM 


directive file so that the operator terminal is available to 


receive any error message that relates to subsequent CLM 
directives. 


If the permanently assigned operator terminal is connected to 
an MLCP/DLCP, both a DEVICE directive and an appropriate communi- 
cation directive (e.g., ATD) are required. (A COMM directive is 
also required.) An MLCP/DLCP-connected operator terminal is 
activated only after system startup is complete. 


In either case, the logical resource number ‘on the DEVICE 
directive must be explicitly specified as 0. Any appropriate 
level number and channel number may be specified. The record_ 
Size argument Should normally be set at 140 bytes (characters). 
Note that the specified record size affects only the file sys- 
tem's use of the operator terminal; regardless of the value of 
record size, the Operator Interface Manager always uses 140 char- 
acters as the maximum for its control of input and output opera- 


tions to the operator terminal. The device name of the operator 


terminal may be any uSer-Selected name (cuStomarily, CONSOLE is 
used). 


Example 1: 
DEVICE CONO00,0,8,X'0500',CONSOLE,140,N,'7200' 


In this example, the operator terminal 1S connected to an 

MDC. The device unit name is CONO0O. The logical reSource 

number is O (a requirement for the operator terminal). The 

priority level is 8. The channel number is 0500. The device 

name is CONSOLE. The record size for file system access is 

140 bytes. I/0 to the device will be unbuffered. The termi- 

nal is a VIP7200. The default for visual display mode, '‘T', —_— 
has been accepted. ae, 
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Example 2: 


COMM 9 
DEVICE TTYO00,0,11,X'FF80',CONSOLE, 140 
TTY 0O,11,X'FF80' 


In this example, the operator terminal is connected to an 
MLCP. The device unit name is TTYO0. The logical resource 
number is 0 (a requirement for the operator terminal). The 
priority level is 11. The channel number is FF80. The 
device name is CONSOLE. The record size for file system 
access is 140 bytes. In the COMM directive, 9 is the prior- 
ity level at which the MLCP will interrupt the central 
processor. In the TTY directive, default values have been 
accepted for modem type and line speed. 


Configuring a Dual-Purpose Operator Terminal 


You have the option to configure a dual-purpose operator 
terminal. A dual-purpose terminal can function alternately as an 
operator terminal and aS a non-operator terminal. Only one 
device in your configuration may be configured in this manner. 
Users control in which capacity the terminal functions (as an 
operator terminal or non-operator terminal) by means of the OPER 
command described later in this section. 


If the device that will function alternately as an operator 
terminal and a non-operator terminal is connected to an MDC, the 
device must be identified by a DEVICE directive with the first 
parameter as CONnn. This DEVICE directive should be the first in 
the file of CLM directives so that the terminal is available to 
receive any error message that relates to subsequent CLM 
directives. 


For an MDC-connected device, the directive is of the form: 


DE VICE CONnn,1lrn,level,X'channel',device name,record size, 
lai tiie |?) aaa terminal name 
7 = ad 


If the device is connected to an MLCP/DLCP, both a DEVICE 
directive and an ATD directive are required. (A COMM directive 
is also required.) An MLCP/DLCP-connected operator/non-operator 
terminal iS activated only after system startup fs complete. It 
is recommended that the terminal not be a dialed line. 


For an MLCP-connected device, the ATD and DEVICE directives 
are of the form: 


DEVICE ATDnn,1lrn,level,X'channel',device name,rec_ size, 
N,,,operator terminal name 


ATD I1rn,level,X'channel',modem,speed,device type,[del], 
[stop-bit][,parity] 
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In either case, the logical resource number (l1rn) on the 
DEVICE directive must be explicitly specified and must be non- 
zero. The lrn you specify will be assigned to the device and the 
file having the name "device name" (fifth parameter). The system 
implicitly assigns lrn 0 to the file having the name “operator _ 
terminal name" (tenth parameter). Lrn 0 may not be assigned to 
any other device. An appropriate level number and channel number 
may be specified. The device name (fifth parameter) you specify 
will be assigned to the terminal when it is functioning as a non- 
operator terminal. An application task group's standard I/O 
files (e.g., command-in, user-in) will be assigned to the device 
name you specify.! You must specify that this device is unbuf- 
fered; the seventh parameter must be N,. 


For an MDC-connected terminal, the tenth parameter in the 
DEVICE directive designates this device as being able to function 
aS both an operator terminal and a non-operator terminal. For an 
MLCP/DLCP-connected terminal, the tenth parameter, operator 
terminal name, must be separated from the seventh parameter, N, 
by exactly 3 commas. The operator terminal name you specify will 
be assigned to users' standard I/O files when the terminal is 
functioning aS an operator terminal. CONSOLE is the customary 
designation.? 


Example 1: 
DEVICE CON00,9,12,X'1380',VIP0O1,100,N,'7200',,CONSOLE 


In this example, the operator terminal is connected to an 
MDC. The device unit name is CONO0O. The logical resource 
number (lrn) is 9. The explicitly stated Irn value of 9 is 
assigned to the terminal when it functions aS a non-operator 
terminal. An lrn of 0 is implicitly assigned to the terminal 
when it functions aS an operator terminal. The priority 
level is 12. The channel number is 1380. The name assigned 
to the terminal when it is functioning as a non-operator 
terminal is VIPOl. The record size for file system access is 
100 bytes. The seventh parameter must be N, specifying that 
this device is unbuffered. The terminal type for this device 
1s 7200. The default for visual display mode has been 
accepted. The name assigned to the terminal when it is func- 
tioning as an operator terminal is CONSOLE. 


Example 2: 


COMM 8 
DEVICE ATDOO,9,15,X'FF80',VIP00,80,N,,,CONSOLE 
ATD 9,15,X'FF80',0,9600,7200 | 


1 Only one application task group can be asSigned to the device 
name you specify. 


Any number of application task groups can be assigned to the 
operator terminal name you specify. 
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In this example, the operator terminal is connected to an 
MLCP. The device unit name is ATDOO. The logical resource 
number is 9. The explicitly stated lrn value of 9 is 
assigned to the terminal when it functions aS a nonoperator 
terminal. An Irn of 0 iS implicitly assigned to the terminal 
when it functions aS an operator terminal. The priority 
level is 15. The channel number is FF80. In the COMM 
directive, 8 is the priority level at which the MLCP/DLCP 
will interrupt the central processor. 


In the DEVICE directive, the name assigned to the device when 
it is functioning aS a non-operator terminal is VIPOO. The 
record size for file system access is 80 bytes. The terminal 
must be designated as unbuffered (the seventh parameter must 
be N). The name assigned to the terminal when it is func- 
tioning aS an operator terminal is CONSOLE. 


In the ATD directive, the modem type is 0 (direct connect). 
The line speed is 9600. The device type is 7200. Defaults 
have been taken for del, stop-bit, and parity. 


At system startup, the terminal is running under the system 
task group and functions aS an operator terminal. The ini- 
tial switch from operator control to user control must be 
accomplished through an EC file you create. The location and 
purpose of this EC file should be communicated only to 
selected users. 


The EC file must contain the following commands: 


OPER -OFF |-IM 
= DEF 


SG group _id user _id level user _in -WD path -POOL pool id 


The OPER -OFF command transfers control of the terminal from 
operator control to user control. The -IM control argument 
(the default) allows all messages processed by the Operator 
Interface Manager (OIM) to be displayed while the terminal is 
running under an application task group. 


The -DEF control argument defers all OIM-processed messages 
until the terminal is returned to system task group control. 
However, meSSages sent to the terminal by two system rou- 
tines, OPMSG and OPRSP, are never deferred. These messages 
are displayed immediately to allow the operator or user to 
respond to volume mount requests or ‘device not ready‘ mes- 
sages. Messages sent to the terminal from other terminals 
uSing the MSG command are also not deferred. If a user 
specifies the -DEF argument and the OIM has deferred an 
output order, the OIM will issue a meSSage at regular inter- 
vals stating that output is pending. 
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The spawn group (SG) command initiates the appropriate user 
group for the application. The spawn group command creates or 
an application task group whose lead task must be the command a 
processor. (The CG and EGR commands may be substituted for a 
the ee Omen es ) The user-in file must be the same as the 
'device name' specified in the DEVICE directive when the 
terminal was OTERO 


If a user grees the terminal to function aS an operator 
terminal, he must execute the command OPER -ON. A message 
will appear at the terminal stating "OPERATOR HAS CONTROL". 
If at any time, a user wishes to return control of the termi- 
nal to his application task group, he must type the command 
OPER -OFF. 


system Configured Without Operator Terminal 


A system configured without an operator terminal has the 
following characteristics!: 


e A SOPMSG (operator information mesSage) or SOPRSP 
(operator response meSSage) macro call to the nonexistent 
operator terminal results in a 0802 error return (invalid 
logical resource number) to the issuing application. 


e No operator terminal is available to record system error 
messages, ready device meSSages, and mount volume mes- 
sages. AS a result, error returns to the issuing applica- 
tion occur immediately: 


- An input/output order to a device that is offline or not 
ready results in a 0105 error return (device not ready) 
to the application. 


- A GET command or $GTFIL (get file) macro call to reserve 
a volume that is not mounted results in a 020C error 
return (volume not found) to the application. 


- A read or write hardware error resultS in a 0107 error 
return (hardware error) to the application. 


e No system-supplied message can be issued to signal the 
termination of system startup. 


1In a system configured with an operator terminal, these same 
characteristics apply within any task group that has used the 
SCMSUP (console message suppression) macro call to temporarily —_ 
suppress messages to the operator terminal. oe 
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File System Pathname in CLM Directives 


( Whenever the format of a Configuration Load Manager (CLM) 
directive indicates that a file system pathname is to be supplied 
aS an argument, the pathname must be expressed in one of three 
forms: | 


1. A full absolute pathname. 


This form of pathname is required to identify a file on a 
disk volume other than the system (bootstrap) volume. 


A full absolute pathname begins with a circumflex (7) and 
a disk volume root directory name (which is the same as 
the volume id). Each successive element in the pathname 
is preceded by a greater-than sign (>) and is hierarchi- 
cally subordinate to the preceding element. Every ele- 
ment in the pathname except the last is a directory name. 
The last (rightmost) element is a file name.' The last | 
element is not followed by any symbol or punctuation. 


Example: 
CLMIN “USRVOL>DIR_1>FILE A 


In this example, a full absolute pathname is used in a 
os CLMIN directive. The pathname indicates a target file 
‘ that exists on a disk volume other than the system 
: (bootstrap) volume. 


2. An absolute pathname. 


This form of pathname is used to identify a file on the 
System (bootstrap) volume or a nondisk peripheral device. 


An. absolute pathname begins with a greater-than sign (>) 
and the name of a directory or file that is immediately 
Subordinate to the root directory of the system volume.?2 
The rest (if any) of the pathname is similar to the full 
absolute pathname described above. 


1In non-CLM environments, the last element in a pathname may be 
either a directory name or a file name, as appropriate to the 
Situation. 


?For a magnetic tape file, the absolute pathname must be !device _ 
unit>volume id>file name. The value for device unit must be 
Specified in the related DEVICE directive. 


For other nondisk peripheral devices, the absolute pathname must 
be !device name. The value for device name is as specified in 
the related DEVICE directive. (If device name is not specified 
in the DEVICE directive, the value of the “device | unit argument. 
is used for device_ name.) 
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Example: 


DRIVER >DIR_Y>USRDRV LY 
In this example, an absolute pathname is used in a DRIVER 
directive. This pathname indicates a target file that exists 
on the system volume. DIR Y is a directory immediately sub- 
ordinate to the root directory of the system volume. 
3. A relative pathname. 
During execution of the Configuration Load Manager, this | 
form of pathname is used to identify a file in the system | 
task group's working directory, in this case directory 
SID, which is immediately subordinate to the root direc- 
tory of the system volume. ("Relative" means relative to 
the working directory of the task group.) 
In this situation, the relative pathname is expressed as 
a simple file name with no preceding or following symbols 
or punctuation. ! The named file must exist in directory 
SID on the system volume. 
Example: 
LDBU RBRCIP 
In this example, a relative pathname is used in an LDBU 
directive. This pathname indicates a target file that 
exists immediately subordinate to directory SID on the 
system volume. 
In all types of pathnames, a directory name cannot exceed 12 
characters, a file name cannot exceed 12 characters, and the 
total pathname (including ~ and > characters) cannot exceed 57 
characters. Ina full absolute pathname, the volume root direc- 
tory cannot exceed six characters. The first character of each 
directory name and each file name must be alphabetic or a dollar 
Sign (S$). 
'Other forms of the relative pathname exist, but their use with -_ 
the Configuration Load Manager is discouraged. Ne 
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CLMIN 


CLMIN DIRECTIVE 
Directive Name: CLMIN 


A CLMIN (CLM input) directive causes the source of CLM 
directives to be changed from the current device/file to the 
one indicated by the pathname argument. All subsequent CLM 
directives are read from the indicated device/file (unless it 
too contains a CLMIN directive). 


Format: 

CLMIN pathname 
Argument Description: 
pathname 


Consists of an ASCII string that identifies the file sys- 
tem pathname from which subsequent CLM directives will be 
read. 


Functional Description: 


In a file of CLM directives, a CLMIN directive cannot appear 
ahead of the DEVICE directive that identifies the device 
implied by the pathname argument. 


When a CLMIN directive is read by the Configuration Load 
Manager, the input file is immediately transferred to the 
beginning of the device/file indicated by the pathname. 
Subsequent CLM directives are read from the indicated device/ 
file. 


If a disk or magnetic tape volume is indicated by pathname, 
that volume must be mounted before system startup begins. 


Example l: 


CLMIN “ABCVOL>BETA1 


In this. example, subsequent CLM directives will be read from 
a file named BETA] on disk volume ABCVOL. An absolute disk 
pathname is used. Volume ABCVOL must be mounted on a disk 
device whose DEVICE directive has already been read by the 
Configuration Load Manager. 
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CLMIN 


Example 2: 


CLMIN !CDROO 


In this example, subsequent CLM directives will be read from 
card reader whose device unit name is CDROO. (ASSume that 
the DEVICE directive for CDROO did not include a device name 
argument; in this case, the device unit argument value is 
used for file system references to the device.) The DEVICE 
directive for CDROO must already have been read by the Con- 
figuration Load Manager. 
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COMMENT 


COMMENT DIRECTIVE 


Directive Name: * (asterisk) 


The COMMENT directive is used to include a comment in the 
file of CLM directives. 


Format: 


* comment text 
Functional Description: 


When a * (aSterisk) is the first character of an entry in the 
file of CLM directives, the remainder of the entry is treated 
aS a comment and is not processed by the Configuration Load 


Manager. 


Comments can alSo be included on other CLM directives if they 
follow a blank after the last argument of the directive. 
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DEVICE DIRECTIVE 
Directive Name: DEVICE 


A DEVICE directive is required for each MDC-connected periph- 
eral device in the system. You may allow the system to 
dynamically assign channel numbers to appropriate devices on 
the bus. You must include a special format of the DEVICE 
directive in your CLM file if your installation will use a 
dual-purpose operator terminal. Refer to "Configuring a 
Dual-Purpose Operator Terminal" earlier in this section. 


Format: 


DEVICE device unit,lirn,level,X'channel', [device name], 
u = 
[ esl inl Ja eine 


Argument Description: 
device unit 


A string of five ASCII characters. The first three char- 
acters identify the type of device; the last two charac- 
ters (alphanumeric) must be unique within the device type 
So aS to identify one specific device of that type. 

Table 5-2 indicates the permissible values of device 
unit, the device type indicated by each value, and the 
default physical record size (in bytes) for each device 


type. 


Except where indicated, the default record size can be 
overridden by use of an explicit record size argument in 
the DEVICE directive. 7 


In the case of KSRnn, the device unit argument also 
establishes the following characteristics for the 


terminal: 

e Trailing carriage return option specified. 

e Trailing line feed option specified. | 
@e® Leading control byte option specified. | 
@e Echo mode option specified. | 
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If you wish to change any of these characteristics of the 
terminal, you can do so by means of an STTY (set terminal 
characteristics) command, a S$STTY macro call, or a STTY 
directive. 


ADIAAC 


Table 5-2. Unit Values and Default Record for Various Devices‘ 


Default Physical 


Device Unit Record Size in 
Value Device Type Indicated Bytes (Decimal) 


KSRnn/CONnn Terminal (MDC-connected)* KSR-73 CON-80 


LPTnn Line Printer 

SPTnn Serial Printer 

CDRnn Card Reader 

CRPnn Card Reader/Punch 

DS Knn Diskette 

RC Dnn Removable Cartridge Disk 
FCDnn Fixed Cartridge Disk 
MSMnn Mass Storage Unit 


RCMnn Removable Cartridge Module 
Disk 

Fixed Cartridge Module Disk 

Magnetic Tape (7-track) 

Magnetic Tape (9-track) 


FCMnn 
MT7nn 
MT9nn 


The KSR device unit value is included for compatibility 
with previous releases. The CON device unit value 
should be used when creating a new CLM directive file. 
The CON device unit value must be used if the user 
intends to perform forms processing from an MDC- 
connected VIP 7200 or VIP 7205 terminal. Using the KSR 
device unit value and the CON device unit value will 
cause two different device handlers to be loaded. 


The default record size for this device cannot be 
altered by means of the record size argument of the 
DEVICE directive. 


It is not necessary to issue a GET command or a SGTFIL 
(get file) macro call to establish the logical record 
Size (and block size). The record size cannot be 
altered by the record size argument of the DEVICE 
directive. 7 


d : : : ‘ : : 
Communications devices are described in Section 6. 
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DEVICE 


lrn 


specifies the logical resource number by which the device 
is requested. The value for lrn is a decimal integer 
from 3 through 252. (l1rn 0 is used for the operator 
terminal. I1rn 1 is used for the bootstrap device. Irn 2 
is reserved for system uSe.) 


level 


Specifies the priority level used by the device driver 
for this device. The value for level is a decimal 
integer from 7 through 59. 


X'channel' 


Specifies the 4-digit hexadecimal channel number of the 
device. (The leftmost 10 bits specify the channel 
number; the rightmost six bits must be zero.) 


If you specify the channel number by a Single zero (0), 
the system will automatically assign this device to an 
appropriate channel. 


If a DEVICE directive for a disk device contains an Irn 
of 1 and a channel number of zero, the bootstrap device 
channel number replaces the channel number of zero. 


[device name] 


For disk and magnetic tape devices, the device name argu- 
ment must be omitted or specified as * (asterisk) because 
the device identity is established by the value of the 
device unit argument. (The significance of using the 
asterisk is described below.) 


For devices other than disk or magnetic tape, device name 
can be one of the following: 


1. A string of up to 12 ASCII characters that establish 
a unigue name by which the device is referred to 
within the file system. The first character of the 
String must be alphabetic. 


2. Omitted, in which case the value of the device unit 
argument is used for file system references to the 
device. | 


3. A * (asterisk), which indicates a "private" device to 
be accessible only through physical input/output. 
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site, 


[record size] 


The length, in bytes, of one physical record. If record_ 


size is not specified, the default record size is as 
eStablished by the device unit argument. (The default 
record size for disk devices and magnetic tapes cannot be 
modified by the record size argument.) 


This argument is meaningful only for devices other than 
disk and magnetic tape. 


For normally unbuffered devices (viz., CDR, CRP), B indi- 
cates that input/output to the device is to be buffered. 


For normally buffered devices (viz., CON, KSR, LPT, SPT), 
N indicates that input/output to the device is to be 
unbuffered. 


Input/output to a buffered device may be either asynchro- 
nous or synchronous; tabulation characters are expanded 
into space characters. Input/output to an unbuffered 
device is always synchronous; tabulation characters are 
not expanded. 


NOTE: All arguments of a DEVICE directive must be unique 


(i.e., not duplicated on another DEVICE directive) 
with these exceptions: (1) the B/N argument need not 
be unique, (2) for pairs of removable/fixed cartridge 
disks, the same level number and channel number must 
be specified for both platters (3) multiple communica- 
tions devices may be configured on the same level and 
(4) multiple (polled) VIPs may be configured on the 
same channel. 


['terminal type'] 


Applies only if the device unit value is CON. Specifies 
the physical terminal type. Possible values are 
described below: 
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DEVICE 


Value Physical Device Type 


'7200' VIP 7200 (DKU9103) 
VIP 7205 (DKU9102) 


The value 7200 must be used if MDC-connected 
VIP 7200 terminals are to be used for forms 

processing using the Display Formatting and 

Control facility. 


"PRU! PRUIOO1/PRU1003/PRU1005/TWU1001/TWU1003/TWU1005 


'D7200' VIP 7207 


"KSR' The value KSR is used if the physical termi- 
nal type is to be supported in teleprinter 
mode. 


[C/T] 


Applies only if the device unit value is CON. Specifies 
the visual display mode for the device. The value C 
indicates CRT mode. The value T indicates teleprinter 
mode. If C is specified, typed input will appear without 
edit control characters (as it appears in the memory 
buffer). If T is specified, typed input will appear as 
it was keyed-in. The default value is T. 


Functional Description: 


Each peripheral device in the system must be identified in a 
Separate DEVICE directive. The device unit argument (e.g., 
DSKO1) identifies both the type of device (DSK) and one 
specific device (01) of the indicated type. The lrn, level, 
and channel number of each device must be unique (except in 
the case of a pair of removable/fixed cartridge disks, in 
which case the level and channel for both platters must be 
the same). 


The first DEVICE directive for each device type causes the 
appropriate device driver to be loaded as part of the system. 
Each device driver is re-entrant, so that only one copy of 
each required driver is loaded to service all devices of the 
Same type. 


A DEVICE directive for the bootstrap device is optional. If 
none is specified, the bootstrap device is assigned priority 
level 6 (the default). If you wish to override the default 
priority level, you should specify a DEVICE directive that 
indicates the appropriate device unit, logical resource num- 
ber 1, desired priority level, and a channel number of zero 
(e.g., DEVICE DSKO00O,1,level,xX'0'). If the channel number is 
not zero, the following message is issued: 1345 CMD (DEVICE) 
SPECIFIES DUPLICATE DEVICE TYPE/UNIT. 
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Example 1: 

DEVICE LPT01,12,20,X'1380' 
In this example, the line printer whose unit number is 01 is 
assigned logical resource number 12 and priority level 20. 
This device is connected to channel 1380. The following 
characteristics are established by default: 


e The device name used within the file system will be the 
Same as the device unit (1460, LPTOL). 


e The record size will be 137 bytes. 
e Output to the device will be buffered. 
Example 2: 


DEVICE RCDO1,9,10,X'1400' 
DEVICE FCD0O1,6,10,X'1400' 


This example illustrates DEVICE directives for a pair of 


removable/fixed cartridge disks. The logical resource number 


for each platter must be unique. The level and channel 
number for both platters must be the same. 
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DRIVER 


DRIVER DIRECTIVE 


Directive Name: DRIVER 


The 


DRIVER directive is used to identify a usSer-written 


device driver and one device driven by the driver. 


Format: 


DRIVER pathname,lirn,level,X'channel'[,X'stack size| 
RCT size'][,X'hhhh*] 


Argument Description: 


pathname 


An ASCII string that identifies the file system pathname 
of the device driver bound unit. 


Irn 
Specifies the logical reSource number used to identify a 
device driven by this driver. The value for Ilrn is a 
decimal integer from 3 through 252. 

level 


Specifies the priority level used by the device driver. 
The value for level is a decimal integer from 7 through 
59. 


X'channel' 


Specifies the 4-digit hnexadecimal channel number of a 
device driven by this driver. (The leftmost 10 bits 
specify the channel number; the rightmost six bits must 
be zero.) You have the option to allow the system to 
assign a channel number for this device by specifying a 
Single zero for this argument. If you choose this 
option, you must also specify the X'hhhh' argument 
described below. 
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[X'stack size|RCT_ size'] 


Specifies the sizes in words of (1) the stack required by 
this driver and (2) the resource control table (RCT) used 
for a device driven by this driver. The sizes are speci- 
fied by a four digit hexadecimal number: the leftmost 
two digits specify the stack size; the rightmost two 
digits specify the RCT size. If the stack size and/or 
the RCT size exceed 255 words (decimal) you may use the 
double word hexadecimal format, D'hhhhhhhh', where the 
first four hexadecimal digits represent the stack size 
and the second four hexadecimal digits represent the RCT 
size. If the driver is to use the system routine ZIOSUB, 
the stack size must be at least 22 words for a SAF con- 
figuration and 40 words for a LAF configuration. The 
minimum size for the RCT is 3 words. If a smaller value 
is entered, the system replaces it with 3. The default 
values are 8 words for stack size and 16 words for RCT 
size. You must take the default values for both sizes or 
Specify both. You cannot specify one and take the 
default for the other. 


[X'hhhh'] 


Specifies a four-digit hexadecimal number corresponding 
to the internal hardware id of the device being driven 
by this driver. 


Functional Description: 


The DRIVER directive causes the user-written device driver 
identified by the pathname argument to be loaded into the 
system area of memory. (Because this driver is loaded into 
the system area of memory, the SYS Linker directive must have 
been specified when this bound unit was linked.) The user- 
written device driver becomes a permanently resident part of 
the system software. (If the driver includes initialization 
routines to be executed when the driver is loaded, these rou- 
tines also remain permanently resident.) 


The DRIVER directive causes creation of a resource control 
table (RCT) of the indicated size. It also causes creation 
of a task control block (TCB) with a dedicated priority 
level. Additional data structure initialization is achieved 
as described below. 


The data structures allocated for use by this device driver 
are sufficient only for physical input/output operations. 
The RCT will be used by the driver to interface with the 
indicated device. Input/output from a program can be ini- 
tiated by a SRQIO (request input/output) macro call that 
identifies an appropriate input/output request block (IORB). 
(The format of the IORB is described in the System Service 


Macro Calls manual.) 
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DRIVER 


Each user-written device driver runs at a dedicated (unique) 
priority level. If a given device driver (Single task) a 
drives multiple devices on different channels, one DRIVER ow 
directive is required for each device. Each DRIVER directive _ 
must specify a unique lrn and channel number, and a common 

priority level and pathname (see the example). In this case 

a separate RCT and stack are created for each device but a 

common TCB is used. Multiple devices of the same type, each 

with its own work area, are thus driven at a common priority 

level by a common task. (If a given device driver drives 

multiple tasks, the pathname arguments in each DEVICE 

directive must be identical, but each task must have a unique 
priority level.) 


The initialization of data structures caused by the DRIVER 
directive is Summarized below. 


e An RCT of the indicated size is created. Immediately 
below the RCT, space for a pointer to the TCB is provided; 
one word for a SAF system, two words for a LAF system. 


e The RCT is immediately preceded by a TCB pointer which is 
in turn immediately preceded by the stack. 


e The pointer at the appropriate Irn offset in the logical 
resource table (LRT) is set to point to the channel/level 
word (the first word) of the RCT. 


e The TCB pointer immediately below the RCT is set to point 
to the TCB. 


e The channel and level values of the DRIVER directive are 
entered into the channel/level word of the RCT. 


e The RCT is marked as having no volume descriptor block 
(private volume). Thus the device is accessible only 
thrceugh physical input/output (normally, the $RQIO macro 
call) and not through the file system. 


e The TCB is marked as having a dedicated priority level. 
(The TCB is also set to point to the entry point of the 
device driver.) 


e The remaining area of the RCT is set to zero. The driver 
must initialize the RCT as required. 


Example: 


DRIVER DIRECTORY _1>OWN DRIVER,12,9,X'0300' 
DRIVER DIRECTORY 1>OWN DRIVER,13,9,X'0380' 
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In this example, a user-written device driver whose file name 
is OWN DRIVER is identified. It will be used to drive two 
deviceS under a Single task. The level and pathname argu- 
ments of the two DRIVER directives are the same; the logical 
resource numbers and channel numbers for the devices are 
unique. The RCT for each device will be 16 words. The size 
of the stack required by this driver is 8 words. 
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LDBU DIRECTIVE 


Directive Name: LDBU 


The LDBU directive causes the indicated bound unit to be 
added to the end of the bound unit load list. The bound 
unit's root is loaded into the system area of memory after 
all CLM directives have been read. (Since the root of the 
bound unit will be loaded into the system area of memory, the 
SYS Linker directive must have been specified when this bound 
unit was linked.) Once loaded, the root of the indicated 
bound unit is permanently resident in the system. 


If you wish to incorporate an optional system capability into 
your configuration, such as error logging or defective memory 
trap handling, you might be required to load one or more 
bound unitS uSing LDBU directives. Refer to Sections 7 and 8 
for descriptions of the bound units associated with optional 
system capabilities. 


Format: 
LDBU pathname 
Argument Description: 


pathname 


An ASCII string that identifies the file system pathname 
of the bound unit. 


Functional Description: 


Application-specific code (usually in the form of subroutines 
shared among multiple task groups) that is referred to sym- 
bolically during application execution can be permanently 
brought into memory at system startup by LDBU directives. 

The pathname in each LDBU directive is added to a bound unit 
load list. 


The order of LDBU directives governs the order in which path- 


names are added to the list. If two LDBU directives specify 
the same pathname, the second one is ignored. 


5-32 CB23-03 


After the QUIT directive (the last CLM directive) is read by 
the Configuration Load Manager, the roots of the bound units 
identified by LDBU directives are permanently loaded into the 
System area of memory. The symbol table for each such bound 
unit is added to the system's resident symbol table list. 
Once a bound unit has been loaded, any symbol defined therein 
by an EDEF Linker directive serves to resolve an unresolved 
reference to that same symbol in a subsequently loaded bound 
unit. Otherwise, if a bound unit contains an unresolved 
reference to a symbol, loading stops with an error halt. 


Example: 
LDBU “~ABCVOL>ALPHA1 


In this example, a bound unit named ALPHA1, which is a file 
immediately subordinate to the root directory of a volume 
named ABCVOL, will be added to the bound unit load list. 


A bound unit loaded by means of the LDBU directive may con- 
tain an initialization subroutine table (IST). The IST defines 
one or more subroutines of the bound unit that are to be executed 
once only, immediately after the root is loaded. If a bound unit 
contains initialization subroutines, the Linker directive IST 
must be specified when the bound unit is linked. The label in 
the IST section is the argument to be entered in the IST 
directive. 


The format of an IST section is given below: 


label DC 0 
RESV SAF,0 RFU 
DC <subl parameters to subroutine subl (may 
DC 0 be any sixteen bit value) 
DC 0 
DC <sub2 ) parameters to Subroutine sSub2 (may 
DC 0 ( be any sixteen bit value) 
DC 0 


1If the entry is 0, all memory used by the initialization subrou- 
tines is returned to the system after the subroutines have been 
executed (provided the subroutines have not caused the system to 
create data structures on their behalf). To retain a subroutine 
in memory, specify n, where n is the number of words to be 
retained. In this case, take care not to extend the memory 
requirement beyond that allocated to the bound unit's root when 
it was loaded. 
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LDBU 


DC <subn parameters to subroutine subn (may yee 
DC 0 be any sixteen bit value) f 


DC 0 


RESV  SAF,0 End of table sentinel 


subl Ste. Se elves 
sub2 Seats ante Weta 
subn See eteoes 


Upon entrance to a subroutine, register B5 contains the 
return address. Before exit from the Subroutine, register Rl 
must contain the status. A value of zero indicates correct exe- 
cution. A nonzero value is the error code for this subroutine. 
If the status is non-zero, the following message is written to 
the error-out file, anda halt occurs. Execution of CLM cannot 
continue. 


134B INITIALIZATION SUBROUTINE ERROR 


(error code returned to register Rl) 
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MAP Directive 


Directive Name: MAP 


The MAP directive provides configuration information that 
enables you to verify the success of certain aspects of the 
system building process. The information presented by this 
directive includes the system physical attributes, system 
Structures, device status, uSer-defined variables, and memory 
pool specifications. This information can be used to ease 
the debugging of system extensions and uSer-written device 
handlers. In addition, information (such as system symbols) 
1S presented that would otherwise be unavailable. 


Format: 
MAP [path] [,map form, ] [,map form,] ... 


Argument Description: 


path 


Pathname of the file to which the map listing is to be 
written. The pathname cannot be that of a communications 
device. The pathname muSt be able to be verified when 
the CLM reads the MAP directive. 


If the pathname refers to a device file (e.g., !LPTOO), 
that device must have been configured when the MAP direc- 
tive is read. 


If the pathname refers to a disk file, the indicated 
volume must be mounted on the drive of a device that is 
already configured and recognized by the file system when 
the directive is read. If the pathname refers to a disk 
file that does not exist, the file will be created (as 
long as the directory structure identified in the path- 
name already exists). If the file already exists, it 
must be a variable sequential file. In this case, it 
will be opened in “renew" mode. 


The default map path value is >SID>CLM MAP. 
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Any combination of the map format arguments described 

below can be entered in any order. If none of these 

arguments is specified, the entire system map is written 

to the map file. The complete map presents the following 

information (in the order shown): 

e System physical attributes 

e system structures 

e User-written device driver attributes 

e Device status for devices accessed by the file system 

e User-defined variables 

@e Memory pool attributes 

e System extensions 

e User-selected permanently resident system overlays and 
system overlaysS made resident to serve as device 
drivers 

e System symbol table 


-BRIEF 
-BF 


Requests display of only the physical attributes, system 
structures, uSer-written driver attributes, and user- 
Selected permanently resident overlays. 


—-NDEV 
-ND 


Omits from the map the data pertaining to device status 
(devices accessed through the file system). 


-NVAR 
—-NV 


Omits from the map the data pertaining to user-defined 
variables. 


-NPOOL 
-NP 


Omits from the map the data pertaining to memory pools. 
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-NRES 
-NR 


Omits from the map the data pertaining to user-selected 
permanently resident system overlays and system overlays 
made resident to Serve as device drivers. 


-NSYM 
-NS 


Omits from the map the data pertaining to the system 


symbol table. 
Example 1: 

MAP —-NS 
The system symbol 
map iS written to 
>SID>CLM MAP. 
Example 2: 

MAP !CONSOLE 


The entire map is 
console output in 


table data iS omitted from the map. The 
the map file whose pathname is 


produced and written to the console. The 
this example is as follows: 
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MAP 


\ 


CSrearTertroersa 


CLM MAP 
PHYSICAL ATTRIBUTES: 


~—6LOCUS6 MUDEO0NeL 2.1 905/S2K/1450 
SIP PRESENT 
NO CIP PRESENT 
MMU PRESENT 
HIGH PHYSICAL MEMORY ADDRESS: 3FFFF 
HIGH VIRTUAL MEMORY ADDRESS: O6EDFF 
TIME BETWEEN REALTIME CLOCK JNTERRUPTS: $e 
OPERATOR CONSOLE CONF LGURED 
ERROK MESSAGE LIBRARY IN USE 


SYSTEM STRUCTURES: (DECIMAL NUMERIC VALUES) 


45 IRKS, 36 TSAS, 10 SYSTEM (IVERLAY AREAS, 
0 RECORD LOCKS CONFIGURED 


USER@WRITTEN DRIVERSS 


Z1U488 KFLUCATION= S501  END= 5B80 ENTRY ADDRESS= 59DA 
LRN=20 LEVEL=21 CHANNFLEFEOO TCH AT SBK6 RCT AT 5SDED 
STACK ALLUCATION SBEA 10 SDEA 

710488 RELUCATIUN= SFAO  END= 661F ENTRY ADDRESS= 6479 
LRNE21 LEVEL=22 CHANNEL=C000 ICR AT 6655 RCT AT 670C€ 
STACK ALLUCATIUN 6689 TO 6709 

Z1NG88 RELOCATIOW= SAO  END= 661F ENTRY ADDRESS= 6479 
LRN=22 LEVELS22 CHANNEL=A000 [CH AT 6655 RCT AT 691C 


STACK ALLUCATION 6908 TO 6919 


DEVICE STATUS: (DEVICES VISIBLE Th FILE SYSTEM) 


SYMPID CHANNEL DEVICE VOLUME USAGE AVATLABLELSECTORS VOLUME MEMBER 


NAME TYPE Jv PHYSICAL LOGICAL SET NAME NUMBER 
RCDO0 1400 e352 “CHECKL $4 0 0 
MSM01 1800 2361 i ») 

RCDO1 1440 2332 7 I) 
DSKOO 0400 2010 “VLb6226 1 502 S02 
NOSKO1 0480 2010 “CLM 0 154 154 
DSKO2 1200 2010 0 
DSKO3 1280 2010 “Rts 0 195e 1952 
CUNSOLE 500 201A 2 
CDROO 1300 2008 i ) 
L.PTO0 1386 2002 ! 


USER@DEFINED CLM VARIABLESS 


A= H = 50 C = 500 D = 5000 — -£ = 50000 
F = 5555 Jos FEEFEFFFF K = FFEFFECE ©) = 0 P = 12C 
Q = 0 W = FEFFFCCA 2 = ERFFEDAO 
MEMURY PUULS: 
$$  START=9980 ENDZLOEFF SLZE= 7580 VIRTUAL BIASES. 0 
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ATTRIKHUTES= P USER°’S RING NUMRER= 0 


AL START=20000 END=S=2CQO0OFF SI/tE= 100 VIKTUAL KIAS= F100 
ATTRIBUTES= EP USEK’S RING NUMBER= 1 
AK START=30000 END=301F F SIZE= 200 VIRTUAL BHIAS= 1F000 


ATTRIBUTES= EPCSU 
AB START=40000 
ATTRIHUTES= PC 


USER?S RING NUMBER= 2 
END=6E DDE SIZE= CFDEO VIRTUAL BIAS= 2EE00 
USER?S RING NUMBERS 1 


AM STARI=40000 ENDS=4003F SIZE= 40 VIbTUAL BIAS= 2EE0O 
ATTRIBKHUTES= CS USER’S RING NUMBERS 1 
AN START=40000 END=400SF SIZE= 60 VIRTUAL BILAS= 2EENO 


ATTRIBUTES= PSU USER“’S RING NUMRERS= 2 


dvi 


3=39 


LDBU“S: CSYSTEM EXTENSTUNS) 
Z1048B START= 5501 
Z10488 START= SFAO 
ZXDEFM START= 70084 
OVLYCT START= 7EFE 
VLDCO START= 844¢ 
RESOLA’S:S CPERMANENTLY RESIDENT EXECUTIVE OVERLAYS) 
OX SITARI=4H9D e OLODK START=3102 eo OLOLP STARTHS35F 3S P) 
ULUCR SITART=52DHK , tIXPCLI START=&F 66 y “LOT MS START=8AE6 ’ 
(IXPCL2 SIARTEH9I70O 3 , UXGRIE2 START=8777 = , UXPCLS START=9001. , 
OTUIMO STARTER9OKA , ULOIMS STARTZBHAD , FUOKIND START=4533— =, 
OORUU2 SIARTSHNOE , CUERS2 STARTS9345A  , OYASE STARTS9777.—Oo, 
OYCRR START=8D40 rp OYET START=8617 er WZAVRE STARTSIO4AIL ’ 
OZACCK STAKI=4360 eo ULXER START=96A0 » UYCKPT START=&BD2 ’ 
SYSTEM SYMBUL. TABLE s 
Z3EXEC 
LOCATIONS 
ZIOUSUB = ESD ZXSTMX = 116E ZXVLN = 112 
ZIUORFQ = 1097 ZTATON = 1110 ZMUSVU = BOD 
ZMBSPO) = AFE @MRSVO = KIO ZMRSPI) = BOl 
ZMSWAP = AF2 2ZMRLUU = AFS ZMRLIN = AF8 
ZMRASD = AFR ZIQADP = 1137 ZIOERP = 11348 
ZIGEND = €05 7ltUTRW = FOA ZMRUWN = BIE 
/XMCLX = DAF 2MSS( = Vk 34 ZXSPRQ = IBHUE 
ZXSPI = ICCB 7XCKRT = 1CC8 ZMACG = LE SE 
ZXStIP = 17448 “XCCST = 20t5 /XIPSI = 1456 
ZXK ISA = IDCC ZXIwil = 124A ZXISTK = Die 
ZYQPF3 = 2215 ZYCLFS = 2e2v LYFM = 215A 
ZYRKDR = 21D6 ZYSM2 = 2134 ZYSM = 216A 
ZXIRML = IF4A XXDATA = () XYCS = 9AK 
XMUMGR = ABS XM GET = #eRB XM_RIN = HCH 
XXCKIT = Ce2C XXLERCT = C72 XXMVCP = C90 
XXDTAH = CCF XXTRH = CFe2 XXTSTIK = ODte2 
XT) = WAC XPUIMK = FIA XFOMGR = 108E 
XISPNS = 1180 XXWAIT = 11F3 XXDOU = 1267 
XXPUST - 1I3F3 XXTERM = 14EA XXSEM = 1579 
XXTKAP = L6BA XUAMGR = 17Ats XOLUAD = 1LB4F 
XOROUT = 1807 XOVMGR s 19BC XUERS = 1862 
XXREQ = IBJF XxSIu = 1C49 XXTSKR = 1CA2 
XXSTSK = 1D66 XXMCL = 1D8B XXGRPR = 1€13 
XXAVKR = 1€C3 XXQDQ Ss 1EDB XXTRML = I1F4A 
XXWCS = IFSC XXMBX = IF 61 XXCLAI = 1°76 


MAP 


EDEFS 


XXC UW 
XXC_URQ 
XXMISC 
XZLLFN 
XZSLCD 
XZXDEF 
xYDMS2 
XZRSUB 
XZBPAS 
X ZCONC 
XXUPED 
XXINIT 
ZIvKI 

ZILPI 

ZLUDK 

ZIULD 

ZX_PVC 
ZIOLP 

ZIUXKW 
LIU_XA 
ZITYP 

ZMGE TL 
ZOARUC 


ZORLDS 


ZXCNSR 
ZXC LOI 
ZXVD LUE 
ZXD_UPR 
ZXD LTR 
ZXGCt 

ZXULRCI 
ZXKEW 

ZXSwl 

ZXVPST 
“2XXCA 

LYUPF2 
ZXDFIP 
ZFRMIN 


$TT1CH0 
SMDMO01 


UVERLAYS 


OLX 
QIOLP 
OXPCL! 
UIUIM6 
OXGRIe 
OXPCL3 
WXCGRP 
OXDEK? 
UXKQGP 
OXRQGS 
OXOTK1 
OXCDRV 
UUERS1 
OTUIMe 
OXSItt 
OxSIu4 
OXAVRI 
OXGACT 


—~ 


XXCUCI 
XXCMGR 
XYEXT 
XxZM400 
XZVL. 
XYOMD 
XZ0SUB 
X7S™M 
XZSMD 
X/GF DB 
XXPTCH 
“YXPA?Y 
ZTERLG 
ZIUAVR 
ZIVOERL 
ZIUTMO 
ZIUSCH 
ZIOTRG 
ZT0U LAD 
ZTOTER 
ZITYPR 
ZMKTRN 
ZOLORT 
ZTVIUD 
ZXCNRW 
ZxXC LRU 
ZXD DH 
ZXD ORC 
ZXECA 
ZXISTR 
ZXMCLT 
ZXSCK 
ZxuU0UT 
ZxXwt 
JYDMe2 
ZMOMO 1 
ZXTHEX 
ZFRMRG 


$XGCK 
bMDM02 


U10DK 

OQIOCR 

UTQLIMS 
UXCTSK 
OXCOVI 
UxXPCHU 
UXSMCL 
UXDFSP 
UXGRAS 
UXGRS2 
OXGRAT 
(IX ACSP 
GQIOIM1 
OXC UIT 
oxsI02 
OXTRR 

OLOIMa 
OXxTR1I7 


[| | | | | | | | | | 
—_ 
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XXC LIN 
XXE SW 
XYINT 
X/UVM4 


XZVLM4. 


XYDMR1 
X ZBF 
XY¥SM 
XZSUB 
XXGSPN 
XTUDK 
ZICWMOR 
ZIKSR 
ZIUCR 
ZIQOINI 
ZIOURG 
ZIUVASD 
ZLUTVC 
ZIULSI 
ZITAPE 
ZMGE TH 
ZOALDC 
ZORELS 
ZUERS 
ZXC CK 
ZXDW 
ZXO LPP 
JXDOER 
ZXECA 
ZXLMVE. 
ZXPUST 
ZXSRCI 
ZXUPFD 
ZXXCA 
LYFM2 
ZMDMO2 
ZUDM01 
ZFRMAT 


SXSFIP 


WFEMCRI 
OIOTPE 
OXPCL2 
UXHXFR 
UVLOIMS 
OXDISK 
OXDFRI 
OXCGRI1 
UXRQAG? 
(IXGRITS 
OXDLGP 
GLOIMO 
UXC XD 
OIUIMS 
OXSI0O3 
Oxwcesi 
OX TRAP 
OXWATL 
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OXGLSSP 
OXUPELD 
UUBIND 
QOROG1 
QDUERS2 
UVASF 
OYDLF 
GOYULF 
OZCRE2 
OZCRFES 
QZULUR 
OYPLEN 
UZGIF3 
UIZbF CB 
UZUPFD 
UYCLS 
OZACLe 
OY 
OZAVRS 
HIZVMi3 
OYSTTY 
OZSME 1 
OYBPCR 
OYDMR2 
OYDMS1 
UZACCH 
UYDMI 1 
UZLUPF 
OZCER 
UZCLINK 
O/7CSUts 
Wi ZDMX 
QOZXLVLI. 
O2ZXSUB 
OZ D1 
OZTEXD 
OZ TUR S 
OZ1SUB 
OZCKET 
UZKEF 
UZKI WR 
(YXMHC 1 
UXMBC 4 
UXMHA2 
OXmMbBLe? 
UXMBS $ 
(IXMBK § 
UXMHIf 
OXMHIG 
UXCKPR I 
UXCKPA 
OXRSTO 
OXRSI3 
OXRSIP 


LOCATIUNS 


210448 
/TOG4BI 


551K 
SODA 


UXE Sw 
OXUPF I 
GQOUMSCO 
VORDO? 
MUERS3 
UY CRE 

UYLKE 

OZALX 

O/CRES 
UZCRRe2 
OYGIF 

DYRMF 

UZCODB 
UZGTRE 
UZUPFF 
UWZCLED 
UYAVR 

WYSwP 

(IZVMI 

WYCWD 

UOYWTEL 
UZSME? 
UYGIGP 
HOYDMR3 
NYUPS2 
U7ZUCCB 
HYOM]2 
NZ TPSN 
W/CINYV 
U/COPF 
UZDMC 

UZXENT 
(IZ XPSN 
OUYDMXe 
UIZTCLE 
UZTUR I 
OZTOR4 
GQZIUTL 
UYRSRI 
UZKIIR 
OZCLPT 
UXMHC) 
OXMBCS 
UXMBA3 
IXMBS] 
UXMBR 1 
UXMHRY 
UXMBTe 
UXELGI 
UXCKP 1 
WXCPAe2 
OXkST I 
OXRSTF 
OXCKPD 


Z10468 


5518 
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OXDGRP 
OMSTAT 
GUPACK 
UOCROT 
WUEML2 
WYCRER 

OYMDFE 

UZALXe 
UZCRF4 
UZLKDR 
OYGTF 

IKZGIFe 
WZCF OH 
WYCUIPN 

(ZOPFU 
UYACL 

GYCMR 

OZAVRe 
UZVMTe 
(1YXPA 

OZSME 

(IiZSMT 

UZHKFe 

U/7DMR 

OZOMS2e 
QZUSUK 
(WYUPI1 
OYDMC 

OZCKEY 
QZCPSN 
OQYDMX 1 
OZXER 

QZXSPL. 
OYDMI 

O/TEGBC 
OLTOPe 
UZTIPSN 
HIYCKPT 
OYUREC 
OZBLOR 
UZROLK 
(XMBC $ 
UXMHAL 
UXMBII 
UIXMtS2 
UXMBR? 
(IXMHI() 1 
(IXMH TS 
UXELG2 
UXCKP2 
UXRSI 

UXRST2 
OXRSER 


ZIU4BA 
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Z10488 
LUCATIUNS 
Z1U484 
Z1U48] 
ZXDEFM 
LOUCATIUNS 
“XINIT 
OVLYCT 
LOCATIONS 
TAX] 
TAKBG 
VLDCD 


1 out 


SFRA 
6479 


7EChs 


7F 1B 
Beit. 


Z10488 = 


TAbe = 
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MEMPOOL DIRECTIVE 


Directive Name: MEMPOOL 


A MEMPOOL directive defines a system memory pool, a batch 
memory pool, an exclusive online memory pool, or a non- 
exclusive online memory pool. Each MEMPOOL directive 
describes only one type of memory pool, but a single MEMPOOL 
directive may describe more than one exclusive online memory 
pool or more than one nonexclusive online memory pool. (You 
have the option of expressing the size of a memory pool sym- 
bolically by defining the size in a VARIABLE directive. See 
the description of the VARIABLE directive elsewhere in this 
section.) 


Format 1: 


MEM POOL S,,Size [,P] 


Format 2: 


MEM POOL B,,S1ize Fataal 
C 
v 


Format 3: 


MEMPOOL { £, | pool_name, J size [,(x] (uJ (P]{(c]{s}]$... 
’ j pool namel 


Argument Description Format 1 


o 
The letter S designates a system memory pool. The system 
memory pool must be defined in a separate MEMPOOL direc- 
tive. If multiple MEMPOOL directives have S as the first 
argument, only the last one is used. 

size 


The size argument is a positive integer that defines the 
number of words requested for the memory pool. To 

specify a pool size greater than 65535% words, use the 
double-word hexadecimal integer format (e.g., D'10A00'). 
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The size of the system pool may also be specified by an 
asterisk (*), in which case CLM will allocate to the system pool 
all memory remaining after MEMPOOL directives specifying explicit 
Sizes have been processed. Only one pool may be defined with "*" 
in its size field. Once any pool has been defined this way, no 
other pool may be so defined. 


If a system memory pool is not defined in an explicit MEMPOOL 
directive, its size is set at 3K (3072) words. 


The size of pools must be in multiples of a certain number of 
words and will be rounded to the next highest multiple by CLM. 
For pools that are neither protected nor contained, the size of 
the increment is 32 words. For pools that are protected or con- 
tained the size of the increment depends on the Level 6 system in 
which they are to be used as shown in Table 5-3. If a pool that 
is protected or contained has the potential of extending into the 
batch pool, the increment for the batch pool must comply with 
that of the extendable pool. 


Table 5-3. Increments for Memory Pools 


Increment 
| System® (Words) 

LAF 

(with 1024K memory) 64K 
LAF | 

(with less than 1024K memory) 256 
SAF 

(with 64K memory) : 4k 
SAF 

(with less than 64K memory) 256 


“Memory pool protection/containment requires 
that the Level 6 central processor possess a 
memory management unit. 


Suggestions for calculating the sizes of memory pools are given 
after the functional description of the MEMPOOL directive. 


P 


The letter P specifies that the pool is protected; i.e., 
users of other non-overlapping memory pools are prevented 
from writing into it. If the argument is omitted the 
pool 1S not protected. If the pool being protected is 
the system pool, the executive code and the system data 
structures are protected along with the system pool. If 
the system being configured does not have the MMU, this 
option is not effective, and a warning diagnostic is 
issued.. | 
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Argument Description Format 2: 


( 3 


The letter B designates a batch memory pool. A batch 
memory pool can be specified only once, in a Separate 
MEMPOOL directive. If two or more MEMPOOL directives 
have B as a first argument, an error occurs. 


size 


Same as for Format l. 


same as for Format 1l. 


The letter C specifies that the pool is contained; i.e., 
users of the pool are prevented from writing outside of 
it. The letters NC specify that the pool is not con- 
tained. The default for batch is contained. If the 
system being configured does not have an MMU, no pool may 
be contained and non-containment is the default. 


Argument Description Format 3: 


So 


E indicates an exclusive (nonoverlapping) online memory 
pool. A MEMPOOL directive that has E as its first argu- 
ment defines one or more excluSive online memory pools. 
Even if your MEMPOOL directive defines more than one 
exclusive online memory pool, you need to specify E only 
once (as the first argument). See Example 5. All exclu- 
Sive online memory pools defined in all MEMPOOL direc- 
tives with E as their first argument constitute a pool 
set. 


A null (no entry) first ‘argument indicates a nonexcluSive 
(potentially overlapping) online memory pool. A MEMPOOL 

directive with a null first argument defines one or more 

nonexclusive online memory pools. 


Each of these pool sets is an alternative definition of 
the same physical area of memory. All pools defined by a 
Single MEMPOOL directive must be either exclusive or 
nonexcluSive. 
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pool name 


The 2-character ASCII name that uniquely identifies each 


exclusive and nonexclusive online memory pool. The pool _ 
name is used in CG (create group) and SG (Spawn group) 
commands and in $CRGRP and SSPGRP macro calls. 


If the pool name begins with a decimal digit, the pool 
name argument must be surrounded by apostrophes (e.g.,_ 


TIA'). 


A pool name argument should not be included in a MEMPOOL 
directive for a system memory pool or a batch memory 


pool. 


The omission of the pool name argument in these 


cases must be signified by a comma. 


NOTE: 


At login you can (1) Specify the two character 
identification of the memory pool, or (2) specify 
a Single character and accept the second character 
asSigned by the facility, or (3) omit the pool 
identification and accept a two-character identi- 
fication whose first character is L. 


If you login by method (2), all online memory 
pools to be used by the login facility must have 
the same first character in their pool name argu- 
ments. This shared first character should not be 
assigned to any other méfmMory pool. In addition, 
it is advisable to assign second characters 
Starting with digits 0 through 9 (in order), then 
letters A through Z (in order); this practice will 
optimize the efficiency of the algorithm used by 
the system's logic facility when it searches for 
an available memory pool. 


You can login by method (3) in the same way as for 
(2) except that the first character must be L. 


If you login by methods (2) or (3), you should 
define at least aS many memory pools as the number 
of users who may concurrently gain access to the 
system. 
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The description of the size argument for Format 1 also 
applies to Format 3. If an asterisk iS not used to 
define the size of the system pool, it may be used to 
define the size of an exclusive or a nonexcluSive online 
memory pool. In this case the pool size is calculated by 
CLM. CLM will allocate to this pool all memory remaining 
after MEMPOOLS with explicit sizes have been processed. 
Once the size of an exclusive pool has been defined with 
an asterisk, no subSequent pool may have its size defined 
by an asterisk. Once the size of a nonexclusive pool has 
been defined with an asterisk, no more pools may be 
defined on that directive line. A subsequent pool direc- 
tive may define the size of a nonexclusive pool with an 
asterisk if the pool is the last pool defined by that 
directive. The size of an exclusive pool may not be 
defined with an asterisk if the size of a nonexclusive 
pool has been defined with an asterisk. 


pool namel 


[X] 


[U] 


[P] 


This option allows the user to refer to a given pool by 
two (or more) names. pool namel is the name of.a pool 
specified by a previous MEMPOOL directive; pool name is 
the new name. The attributes of the pool are specified 
by the original directive and cannot be changed by sub- 
sequent directives that use this option. 


The letter X indicates that the online pool can be 
extended into the batch pool area. If a memory request 
cannot be satisfied within the defined size of the online 
pool, the contents of the batch pool are rolled out of 
memory. If X is omitted, the online pgol is not 
extendable. If the contents of the batch pool are to be 
rolled out of memory upon a SSPB (Suspend batch) operator 
command, at least one online memory pool must be defined 
with an X argument. 


The letter U specifies that groups uSing this pool run in 
the unprivileged mode. Groups running in the unprivi- 
leged mode may not execute privileged instructions and 
will trap if a privileged instruction is attempted. The 
default is privileged. 7 


same as for Format l. 
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[C] 


Same as for Format 2, except that for pools defined by 
Format 3 the default is not contained. 


[S] 


The letter S specifies serial usage of the pool; i.e., 
only one group at a time can use it. An attempt to 
create a second group uSing a serial usage pool results 
in an error return and the second group is not created. 
If this argument is omitted, the pool can be used by more 
than one group at a time. | | 


Functional Description: 


Each MEMPOOL directive causes a pool descriptor list to be 
created. Later, after the memory requirements of the system 
and its extensions are known, each pool set is checked to 
ascertain whether it can fit into the remaining available 
space. If any element or pool set is too large, an error 
occurs. : 


The Configuration Load Manager creates a file named ROLLOUT 
under the SID directory of the bootstrap volume if a batch 
memory pool is defined and at least one online memory pool 
definition includes an X argument. If a ROLLOUT file is to 
be created on a bootstrap diskette, it is usually necessary 
to delete unneeded elements from the bootstrap diskette 
(*“ZSYS00) and then copy the remaining contents of this 
diskette to a backup volume (where the remaining contents 
will be consolidated into a consecutive area). This tech- 
nique will provide the largest possible consecutive area of 
unused space on the backup volume. Using this backup volume 


aS the bootstrap volume, you can optimize the possibility of 


successful creation of a ROLLOUT file large enough to accom- 
modate the batch memory pool. 


The following discussion of the protect. and contain attri- 
butes applies only to a system having an MMU. The system 
pool may be protected or not. It may not be contained. The 
batch pool may be contained or not. It may be protected or 
not; but if it is protected, it will be protected only from 
those pools that have no Poreete: for extending into the 
batch pool. 


All other exclusive nonextendable pools may be protected, or 
contained, or protected and contained, or neither protected 
nor contained. An exclusive pool that is extendable may also 
be contained. However, when such a pool is defined, the 
System does not prevent the user from accidentally writing 
into the batch pool area before the batch program is rolled 
out. 
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An exclusive pool that is extendable may also be protected. 
If such a pool extends into the batch pool area, the part in 
the batch area is protected only if there are no other 
extendable pools. 


The protect and contain attributes apply to all nonexclusive 
pools collectively. If any nonexclusive pool is protected or 
contained, then the set of nonexclusive pools have the same 
attribute(s). Nonexclusive pools may not be individually 
contained or protected from each other. A protected non- 
exclusive pool, therefore, is protected from exclusive pools 
or from the batch pool overwriting its space. It is not pro- 
tected from other nonexclusive pools overwriting its space. 


Guidelines for Calculating System Pool Memory Size: 


The following tables provide guidance in calculating the size 
of the system memory pool. 


Table 5-4 lists the number of words of resident code required 
for various system components; Table 5-4 also lists the number of 
Sharable and/or exclusive files that are used. 


Table 5-5 lists formulas that can be used to calculate file 
memory space. 


Table 5-6 describes memory requirements for various system 
control structures. 


Table 5-7 describes memory requirements for elements in 
online or batch memory pools. 


Table 5-8 describes memory requirements for the Message 
Facility and Checkpoint/Restart (described in the System 
Concepts manual). 


The user is advised that the system memory pool must be large 
enough to handle the "worst case" situation. To compensate for 
pool fragmentation, increase the total pool size by at least 10 
percent. The pool size must be a multiple of 32 words. 
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Table 5-4. Resident Code Required for System Components 7 
All system components not listed below (and not also the subject & Y 
of a separate release bulletin) are less than 200 words. 
Resident 
Component Code Sharable Files peeiusige Files 
Access Control 
Utilities 
Delete Access 1,080 | 
Control 
Delete Common 1,080 
Access Control 
List Access 14545 
Control 
List Common 1,545 
Access Control 
set Access 1,180 
Control 
set Common 1,180 
Access Control 
BU CONVERT 4,969 Input file Output file 
Check Mass 7,273 
storage Volume 
Compare 4,986 Input file 
Output file 
Compare ASCII 2,616 Input file 
| Output file 
Copy -—6«m, 856 Input file Output file 
Commercial 4,500 
Instruction 
Simulator 
Create 380 
Directory 3 
Create File 1,280 
Create Index 1,120 oo 
Create Mailbox 1,611 ef 
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Table 5-4 (cont). Resident Code Required for System Components 


Resident 
Component Code Sharable Files Exclusive Files 


Create Volume Output files Output volume 
(MDUMP etc.) 


OdWAW 


Data Exchange 


Utilities 
Compare Data 3,936 Input file 
Exchange | | Output file 
Copy Data 3,945 Input file 
Exchange Output file 
Create Volume 1,500 Output file 
Data Exchange 
File Change 1,286 Input file 
Data Exchange 
File Dump Data 1,536 Input file 
Exchange 
a List Data 3,284 Input file 
( Exchange Output file 


Debug (S$D) 2,270 Work file 


Debug 1,400 Work file(s) 
(Multi-User) (system 
pool) 


1,500 
(user pool) 


Quick Break- 3,750 

point (system 

Processing pool) + 
user- 
specified 
Size of 
quick memory 
buffers 


Deferred Print/ 1,055 Input file 
Punch 


Delete 790 
Directory 


Delete File 
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Table 5-4 (cont). Resident Code Required for System Components 


Delete Index 


Display 
Formatting 
Create 

Print 

VDAM: — 7 
VFORMS command 


DPEDIT 


Editor 


Ex port 


File Change 


File Dump 


Get File 
Get Quota 
Interactive 
system 
Definition 
(M4_SYSDEF) 


Linker 


List Creation 
Date 


List Names 


List Tape 
Contents 


| ~~ Resident 
Component | Code 


845 


4,140 
1,406 
7,663 

592 


SAF 7,345 
LAF 7,748 


7,111 


(+ 2KW per 
user) 


2,300 


1,354 


1,625 
(+ 300W/ 
user) 


735 
59,700 
4,777 


(+ A4KW Get 
Memory) 


10,750 
(+ default 
Get Memory 


of 2KW) 


2,990 


4,982 


1,417 


FORMS>VDAM FORM 01 


Input file 


Sharable Files 


Output file 


Input files 


Output files 


Input file 


Output file 


Input files 


Input file 


Input file 


Output file 


Output file 


Input file 
Output file 


Temporary work > 


files (CI=128) 


Input file 


Output file 


Output files 


Input file 
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Exclusive Files 


Table 5-4 (cont). Resident Code Required for System Components 


( | Resident | 
Component Code Sharable Files Exclusive Files 


TOONS 


Listener 2,231 Input file 
Load Index 1,885 Output file 
Modify File 1,030 
Patch 10,299 Input file 
Output file 
Prime Index 5,790 Output file 
Print 1,507 Input file 
Print/Punch 6,800 Input file 
Daemon Output file 
Queue Report 1,772 Input file Output file 
Rename Lp 25 
Report Queue 3,000 Input file 
pe Maintenance | Output file 
‘ Restore 3,800 | Input file 
(+2.5K Output file 
Get + 1] temporary 
Memor y) work file 
Reorganize 2,020 Input file 
Indexed File Work file 
Save 2,525 Input file Output file 
(+2.3K + 1 temporary 
Get work file 
Memor y) 
Set Terminal 2,135 
Character- 
istics 
SIP Simulator 2,000 
(Double) 
SIP Simulator 600 
(Single) 
7 Tape | ) | Input file 
( Positioning 
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Table 5-4 (cont) Resident Code Required for System Components 


| a | Resident. | 
~ Component Code Exclusive Files 


TCLC 2,900 


Sharable Files 


TCLP 


gee Note 


Unspool 5,700 Input files 


Walk Subtree 


800 


ZXDEFM 
(Defective 

Memory Trap 
Handler) 


300 


ZXPFR 
(Power 

Resumption 
Facility) 


NOTE: The actual number of words required by the TCLP to perform 
transaction processing depends on the number of concurrent 
users and the mix of transactions they are running. Refer 
to Appendix F in the Transaction Control Language Facility 
manual for the formulas used to.calculate the TCLP memory 
requirements. 


Table 5-5. Formulas for Calculating File Memory Space 


Memory Requirements in a MOD 400 LAF System 


File Reserved Memory Required for 96 + (M x 32) where M is 
Exclusively system Memory Pool the number of buffers 
| (in words) 


Memory Required for 64 + (M x CI size) 


Online (User) Memory 2 
Pool (in words) where M is the number of 
buffers | 
Sharable Fiies| Memory Required for 96 + M(32 + CI size) 
system Memory Pool a a 
(in words) where M is the number of 
buffers 


Memory Required for 
Online (User) Memory 
Pool (in words) 
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Table 


Memory Requirements in a MOD 400 SAF System 


File Re 


Exclusively System Memory Pool the number of buffers 


5-5 (cont). Formulas for Calculating File Memory Space 


served Memory Required for 64 + (M x 32) where M is 


(in words) 


IOOdNAW 


Memory Required for 32 + (M x CI size) 

Online (User) Memory 2 

Pool (in words) where M is the number of 
buffers 


Sharable Files | Memory Required for 64 + M(32 + CI size) 
System Memory Pool 2 
(in words) where M is the number of 


CI size 


NOTE: 


Table 


}|Batch GCB (includes LFT, 
for LFN+LRN < 47 (SAF) 


LRT ) 96 128 O or l 
and LFN+LRN <28 (LAF) | 
For every LFN+LRN above 
these limits, add 1 (SAF) 
or 2 (LAF) words. 


Element Occurrences Product 


The number and size of the various a Structures will vary 
depending on the installation's processing requirements. For 
each item in the "Element" column multiply the word size (using 
the SAF or LAF figure, aS appropriate) by the number of esti- 
mated occurrences to obtain a "Product"; then add all the 
products. 


buffers 
Memory Required for 
Online (User) Memory 
Pool (in words) 


= control interval size 


For all system commands, the number of buffers per file 
is one (unless the user has acted to change this value). 


The control interval size for each command is 512 


(unless the user has allocated a file with a different 
control interval size). 


5-6. Memory Requirements for System Control Structures 
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sc Table 5-6 (cont). Memory Requirements for System 

O Control Structures ES 
= Element SAF LAF Occurrences | Product 

=_ Batch TCB‘s Cincindes lead 


task, execution commands) 
Without SIP 
With SIP 


Rollout Capability O or l 
(Rollout: File and Code) 
Each Active Disk Directory 
and File (include bound 
units as files) | 


Per Command Input/User Input 
File — ~ 
Operator Terminal (MDC) 32 32 n 
Disk® 160 160 n 
TTY (MLCP) 64 64 n 
PRU, CR 96 96 n 
Per User Disk File With % 
Concurrency of "Sharable" 
or Per "Device File"? 
} Management (buffer size) 
Disk? CT#32 1°CI432 n 
PR, PRU a a 
CR, KSR 


Per Bound Unit 
(File overhead - sharable 
or overlays) 


- 


SBUS (SAF) 


S5(number of overlavs) + 
4(number of EDEFed symbols) 
+ code size 


Tape Volume Name Block 


Concurrently Outstanding 
Mount Volume Requests 


Table 5-6 (cont). Memory Requirements for System 
Control Structures 


Element a Occurrences | Product 


| Expanded Trap Save Areas 
for Each Task 


system Overhead ia 


| "Double the word size value if the "device file" is bidirectional 
and buffered. 


IOOdNAWN 


Total Pool Size Without 
Fragmentation (sum of 
Product column) 


| 3) 

Fragmentation Allowance 
(10 percent of item 
immediately above) 


Legend: 


GCB Group control block 

LFT Logical file table 

LRT Logical resource table 

TCB Task control block 

SIP Scientific Instruction Processor 
CI Disk control interval 


“Indexed sequential files must be counted as two files. 


Guidelines for Calculating Online and Batch Memory Pool Size 


The following table provides guidance in calculating the size 
of the online pools and the batch pool. 
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Table 5-7. Memory Requirements for Elements in Online or 
Batch Memory Pools / 


Element anes Occurrences 
EERE Gane 


Product 
Es Spare we eS Rs ee gee A re ig cee See are ee ee 


The number and size of various elements will vary depending on 
the installation's processing requirements. For each item in 
the "Elements" column, multiply the word size (using the SAF or 
LAF figure, aS appropriate) by the number of estimated occur- 
rences to obtain a "Product"; then add all the products. 


oeass, 


GCB (includes LFT, LRT)° 96 128 n 
for LFN+LRN <47 (SAF) 
and LFN+LRN <28 (LAF) 
For every LFN+LRN above 
these limits, add 1 (SAF) 
or 2 (LAF) words. 


TCB's (includes lead task and 
execution commands)’ 


Without SIP 64 96 n 
With SIP 96 128 n 
GROUP REQUEST BLOCKS? 64 96 n 
Work Space for Commands 
Execution Commands 192 192 n 
Commands From Interactive 32 32 n 
Terminal 
TRB (exclude lead task, 64 96 n 
include execution 
commands) 


Per Command Input/User _Input 


File 
Device 32 64 n 
Disk/Tape 64 64 
Per Error _Out/User _Out File 
Nondisk _ 64 64 n 
DiSK 224 224 n 
Per User File (FCB) 32 64 n 
Per User Disk File With CI+32 | CI+32 n 


Concurrency of “Exclusive" 
Under Control of Data 
Management® (buffer size) 


Per Associate File 32 32 n ae 
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Table 5-7 (cont). Memory Requirements for Elements in Online 
or Batch Memory Pools 


Elements SAF LAF Occurrences | Product 
32 32 


IOOdWAWN 


Per User File Under Control 


of Storage Management 


Per Nonsharable Bound Unit NSBUS 
NSBUS (SAF) = 18 + 
5(number of overlays) + 
4(number of EDEFed symbols) 
+ code size 


Per Nonsharable Bound 
Unit (cont) 
NSBUS (LAF) = 25 + 
6(number of overlays) + 
5(number of EDEFed symbols) 
+ code size 


Any Bound Unit With Slow 
Load Section 


| User Requested Memory 


Total Pool Size Without 
Fragmentation (sum of 
Product column) 


Fragmentation Allowance 
(10 percent of item 
immediately above) 


Legend: 


GCB - Group control block 
LFT - Logical file table 


LRT - Logical reSource table 
TCB - Task control block 
SIP - Scientific Instruction Processor 


TRB - Task request block 
FCB -—- File control block 
CI - Disk control interval 


*When calculating the size of the batch memory pool, do not 
include this item since, in the case of batch processing, it 
appears in the system memory pool (see Table 5-6). 


bIndexed sequential files must be counted as two files. 
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Table 5-8. Memory Requirements for Message Facility and 
Abii aa 


Message Facility 


system overhead 


For each task group uSing 
Message Facility 


For each mailbox 


For each mailbox with 
disk queuing 


Checkpoint/Restart 


Permanently allocated 
(for each group uSing 
Checkpoint/Restart) 


Dynamically used during 
every Checkpoint (For 
more than 2 tasks in 
the group, add 192 for 
each additional task) 


Dynamically used during 
every Restart 


Example 1: 
MEMPOOL- S,,4096 


In this example, a system memory pool of 4096 words is 
defined. Because a system memory pool is being defined, no 
pool name argument is specified, but the second comma indi- 
cateS omission of the argument. 


Example 2: 
MEMPOOL B,,12288 


In this example, a batch memory pool of 12,288 words is 

defined. Because a batch memory pool is being defined, no 

pool name argument is specified, but the second comma indi- 
cateS omission of the argument. The batch pool is implicitly 


contained unless the pool size is followed by ",NC", which 
specifies not contained. 
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Example 3: 


MEMPOOL- E,AB,12768,,CD,1024,X 
MEMPOOL E,EF,2048 


In this example, three exclusive online memory pools are 
defined. The three pools constitute the set of exclusive 
online memory pools. The first MEMPOOL directive defines two 
exclusive online memory pools: (1) The first, whose pool 
name is AB, comprises 12,768 words; it cannot dynamically 
extend into the batch memory pool because argument 4 of the 
MEMPOOL directive is null. (2) The second, whose pool name 
is CD, comprises 1024 words; it can dynamically extend (if 
necessary) into the batch memory pool because argument 7 is 
X, indicating rollout. The second MEMPOOL directive defines 
an exclusive online memory pool named EF. This memory pool 
comprises 2048 words. It cannot dynamically extend into the 
batch memory pool because argument 4 is null. 


Example 4: 


MEMPOOL ,XY,512,,UV,%* 
MEMPOOL ,WX,*,X 


In this example, three nonexclusive online memory pools are 
defined (argument 1 in each MEMPOOL directive is null). Each 
MEMPOOL directive defines a pool set; the first pool set 
comprises two pools, the second pool set comprises one pool. 
Because two pool sets are nonexcluSive, they define the same 
physical area of memory (i.e., they overlap). Any contention 
for space within this area of memory will be resolved by the 
system. 


The first MEMPOOL directive defines two nonexclusive online 
memory pools: (1) The first, whose pool name is XY, com- 
prises 512 words; it cannot dynamically extend into the batch 
memory pool because argument 4 of the MEMPOOL directive is 
null. (2) The second, whose pool name iS UV, occupies all 
memory remaining after the pools with explicit sizes have 
been allocated (because argument 6 iS an aSterisk); pool UV 
cannot dynamically extend into the batch memory pool because 
argument 7 is null. The second MEMPOOL directive defires a 
nonexclusive online memory pool area named WX. [It can 
dynamically extend (if necessary) into the Batch memory pool 
(argument 4 is X, indicating rollout). 


The diagram below (not drawn to scale) indicates the rnemory 
pools established by the MEMPOOL directives in exampl?2s 1 
through 4. Note that the two sets of nonexclusive online 
memory pools define the same phySical area of memory. 
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MEMPOOL 


OPERATING HIGH 
SYSTEM MEMORY 


SYSTEM MEMORY POOL AB POOLCD POOL EF POOL XY POOL UV_| BATCH MEMORY 


POOL POOL 
| POOL WX 
EXCLUSIVE POOL NONEXCLUSIVE POOL 
AREA AREA 


Example 5: 


MEMPOOL E,JJ,4096, PCUSX,RR,8000,SU 


This example defines two memory pools; one named JJ, the 
other RR. Both pools are exclusive. The attributes for pool 
JJ are designated by the two arguments that follow the entry 
JJ. The first designates a size of 4096 words. The second 
specifies that the pool is protected, contained, and unprivi- 
ledged, that only one group can use it at a time (Serial 
usage), and that it can extend into the batch pool area. 

Note that the elements of this argument can be entered in any 
order, and that no commas are inserted between elements. 


Pool RR is assigned 8000 words of memory. It is neither pro- 
tected, nor contained, nor expandable; it is unpriviledged 
and requires serial usage. 


Example 6: 


MEM POOL E,KK,4000,PS 


MEM POOL E,LL,KK, ,MM,KK 


This example illustrates the use of the renames option. 

Pool KK is declared first. The second directive specifies 
alternate names for this pool. Pools LL and MM have the same 
attributes as KK. Both are protected since KK 1s protected. 
All three names define the same 4000-word area in memory. 
Since KK is serial usage, LL and MM are serial usage also. 
The serial usage attribute is a function of the pool name. 
Since these three pool names describe the same memory pool, 
three groups can possibly use the pool area concurrently. A 
group uSing pool KK, a group uSing a pool LL, and a group 
uSing MM could all be active at the same time. But, for 
example, two groups using the pool name KK could not both be 
active at the same time. 
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- QUIT 


QUIT DIRECTIVE 
Directive Name: QUIT 


The QUIT directive must be the last directive in the file of 
CLM directives. 


Format: 
QUIT [VER] 
Argument Description: 
[VER] 
The VER argument causes the version (date and time cre- 
ated) of each Configuration Load Manager module used to 


be typed out at the operator terminal. The format of the 
typeout is shown below under the example. 


Functional Description: 

The QUIT directive causes the Configuration Load Manager to 
cease reading CLM directives and to begin its loading phase. 
The following actions occur: 


l. Any required final data structures are created. 


2. If a communications environment has been defined, it is 
initialized. 

3. Bound units (if any) identified in LDBU directives are 
loaded into the system area of memory. 


4. System overlays (if any) identified in RESOLA directives 
are loaded into the system area of memory. 


5. Memory pool descriptors are created, based on the con- 
tents of MEMPOOL directives. Each memory pool set 1s 
checked to ascertain whether it can fit into available 
memory Space. 


6. The Configuration Load Manager terminates. 
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Example: 


QUIT VER 


This example causes the Configuration Load Manager to cease 
reading CLM directives, type out the version identifier of 
each CLM module used, and enter its loading phase. The 
typeout might appear as shown below. 


(SS) CLMVAR 80/10/03/0836 
(SS) CLMST1 80/09/14/0903 
(SS) CLMST2 80/10/02/0808 
($S) CLMDEV 80/10/10/1206 
($S) CLMMMU 80/08/17/1021 
($S) CLMCOM 80/11/08/1530 
(SS) CLMCM2 80/10/15/2105 
($S) CLMCM1l 80/10/15/2104 
($S) CLMCM3 80/10/15/2106 
(SS) CLMCM4 80/10/15/2107 
(SS) CLMFLT 80/10/02/0811 
($S) CLM 80/09/21/0750 COMPLETED 
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RESOLA DIRECTIVE 


Directive Name: RESOLA 


The RESOLA directive identifies one or more system overlays 

that are to be loaded into the system area of memory, where 

they will remain resident for the duration of the configured 
system. 


Format: 


RESOLA overlay name[,overlay name]... 
Argument Description: 


overlay name 


; A string of up to six ASCII characters that identify a 

H system overlay that is to be made resident for the dura- 
* tion of the configured system. Appendix B identifies the 
system overlays that can be specified in this argument 
and the function(s) provided by each one. 


Functional Description: 


Each RESOLA directive adds one or more system overlay names 
to a list of resident system overlays. During the Configura- 
tion Load Manager's loading phase, each name on the list is 
compared with a table of system overlay names. A match 
causes the indicated system overlay to be loaded into the 
system area of memory. 


If no match occurs, an error iS indicated. If one overlay 
name on a RESOLA directive causes an error, all other cor- 
rectly specified overlays in the same direétive can neverthe- 
less be loaded. 


Example: 

RESOLA OYDMT,OZTSUB,OZTUTL 
This example identifies three system overlays (these three 
are used for processing magnetic tape files) that will be 


= loaded into the system area of memory, where they will remain 
| resident for the duration of the configured system. 
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RLOCK DIRECTIVE 


Directive Name: RLOC K 


The RLOCK directive defines a pool of structures to be used 
by data management when record locking is requested at file 
reservation time. The size of the pool determines the total 
number of records that may be locked at one time. 


One structure is uSed for each record to be locked. The size 
of each structure iS six words for SAF and eight words for 
LAF. These structures are reusable after records become 
unlocked. The RLOCK directive must be included if the 
record lock facility is to be used. If more than one RLOCK 
directive is given, the last one takes effect. 


Format: 

RLOCK [init],[inc], [max] 
Argument Description: | 
[init] 


Specifies the number of initial record lock structures. 
The default is 15. 


[inc] 


Specifies the number of record lock structures that can 
be added at one time. The default is 5. 


{max] 


Specifies the total number of record lock structures per- 
mitted. The default is 30. An entry of O Signifies that 
the total number of lock structures is unlimited. I£ the 
initial size or the increment size is greater than the 
maximum size, the following CLM message is generated. 


133A RLOCK ARGUMENTS INCONSISTENT WITH EACH OTHER 
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NOTES: 1. The initial record lock pool is allocated in 
system memory at the time of the first record 
lock request. 


2. The sizes of all three arguments are rounded up 
so that the amount of memory allocated is a mul- 
tiple of 32 words minus 2 for SAF, or 32 words 
minus 3 for LAF. 


Functional Description: 


The record lock facility of the file system provides multi- 
user interference protection for records within shared disk 
files. For a detailed description of this facility see the 
Data File Organizations and Formats manual. This facility 
requires that a pool of record lock structures be created by 
means of the RLOCK directive. Because record lock entries 
are used and surrendered dynamically, the RLOCK pool need 
contain only enough entries to service the maximum number of 
records that will be locked at the same time. The following 
procedure shows how to calculate the size of the record lock 
pool for a system where a number of users perform simulta- 
neous transactions. 


Assume that each transaction consists of an update of three 
records. The file system will lock the control intervals 
(CI's) in which the three records reside, and for indexed 
sequential files it will also lock the record preceding each 
of the accessed records. Thus, a maximum of six CI'S may be 
locked. However, two consecutive records are uSually in the 
same CI; therefore three locked CI's iS a good approximation 
for an indexed sequential file and the exact value for other 
file organizations. 


Assume that ten users perform transactions but never more 
than four users access the data base simultaneously. For 
these assumptions, the initial number of record locks is 12 
(4 x 3) and the natural increment is 3. 


The accuracy of these estimates may be improved by taking 
into account the memory management features. Record lock 
entries are allocated in system memory, and system memory is 
obtained in blocks. (A multiple of 32 minus 2 words for SAF; 
a multiple of 32 minus 3 words for LAF.) In a SAF environ- 
ment, record lock entries are six words long. Therefore, for 
SAF, better eStimates for initial and increment values would 
be 15 and 5. 


Example 1: RLOCK 


Init 15 
inc =: 5 
max = 30 
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Example 2: 


Example 3: 


Example 4: 


Example 5: 


Example 6: 


Example 7: 


RLOCK 


RLOCK 


RLOCK 
RLOCK 


RLOCK 
RLOC K 


RLOC K 


hou ll 


15 


45 Error because 45+5>45 


45 No error 


te 


30 because the last RLOCK 
directive is the effec- 


tive 


20 


15 
5 
unlimited 


CB23-03 


oie 


SYS 


SYS DIRECTIVE 
Directive Name: SYS 


The SYS directive defines a number of system variables. 


Format: 
SSIP 
DSIP 
SYS [Hz],[scan cycle], CIP ,{olan],[tsa],[{irb][,,E] 
SCIP : 
null 


Argument Description: 
[HZ] 


Specifies the line frequency at which the system's real- 
time clock operates. Possible values are 60 (for 60 Hz) 
and 50 (for 50 Hz). Model 20's and 30's should be con- 
figured with a value of 50 if the line frequency is 50 
Hz, and 60 if the line frequency is 60 Hz. Model 40's 
and 50's should always be configured with a value of 60. 
The default value is 60 (the U.S. standard). 


[scan cycle] 
Specifies the time, in milliseconds, between interrupts 
by the system's real-time clock. The default value is 50 


(milliseconds). 


The following values (in milliseconds) are possible for 
Scan _ cycle. 


50 Hz Line 60 Hz Line 
10 8 
20 16 
50 25 
100 33 
50 
100 
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Millisecond intervals in cyclic clock request blocks 
should be expressed (if possible) in multiples of the 
scan cycle. This practice ensures long-term accuracy of 
event synchronization. Otherwise, the full deviation 
between the specified interval and the nearest scan cycle 
multiple is always realized. ~ 


SSIP 
DSIP 
CIP 

SCIP 
null 


Specifies that scientific instructions and/or commercial 
instructions will be used in applications. Commercial 
instructions are processed by the Model 47 or Model 57 
Central Processor in configurations so equipped; other- 
wise, commercial instructions are processed by a software 
Simulator (CIPSIM). Scientific instructions are pro- 
cessed by the Scientific Instruction Processor if it is 
present; otherwise, scientific instructions are processed 
by the software simulator (SIPSIM). 


Note that in configurations with a Model 47 or Model 57 
Central Processor, the commercial extensSion to the inter- 
rupt Save area is automatically created for each priority 
level except for those levels occupied by drivers, 
regardless of the option specified for this argument. 

The presence of a hardware Scientific Instruction 
Processor automatically creates the commercial and 
scientific extensions to the interrupt save area for each 
priority level except for those levels occupied by 
drivers, regardless of the option specified for this 
argument. 


SSIP indicates that single-precision scientific instruc- 
tions are to be processed. If the hardware Scientific 
Instruction Processor iS not present, the single- 
precision SIP simulator (SIPSIM SP) will automatically be 
loaded during the sytem startup. If the hardware 
Scientific Instruction Processor is present, it 1S used 
and the single-precision SIP simulator is not loaded. 
(SSIP is permissible for use with BES 2xx FORTRAN 
programs and FORTRAN programs without double precision.) 


DSIP indicates that double-precision scientific instruc- 
tions are to be processed. If the hardware Scientific 
Instruction Processor iS not present, the double- 
precision SIF simulator (SIPSIM) will automatically be 
loaded during system startup. If the hardware Scientific 
Instruction Processor is present, it will be used and the 
double-precision SIP simulator is not loaded. (DSIP is 
permissible for BES 203 -- and later -~- FORTRAN 
programs.) 


5-70 CB23-03 


CIP indicates that commercial instructions are to be pro- 
cessed. If the required central processor model is not 
present, you must include an LDBU directive that identi- 
fies the commercial simulator (CIPSIM). If the required 
central processor model is present, it will be used and 
the Commercial simulator should not be identified in 

an LDBU directive. 


SCIP indicates that both scientific and commercial 
instructions are to be processed. If the hardware 
Scientific Instruction Processor is not present, you must 
include an LDBU directive that identifies the single- 
precision SIP simulator (SIPSIM SP) or the.double- 
precision SIP simulator (SIPSIM). If a Commercial 
Central Processor model is not present, you must include 
an LDBU directive that identifies the Commercial simula- 
tor (CIPSIM). If the hardware Scientific Instruction 
Processor and a commercial central processor are present, 
they will be used and the SIP and commercial simulators 
Should not be identified in LDBU directives. 


NOTE: If both SIP and commercial simulators are uSed, 
the order of the LDBU directives governs the order 
in which the simulators process a trap to the 
Single trap vector they share. The simulator 
identified in the last LDBU directive will process 
the trap first. 


null (no entry) indicates that no scientific or commer- 
cial instructions are to be processed or that any 
required hardware Scientific Instruction Processor and/or 
a commercial central processor model is present and will 
be used. (Thus the corresponding simulator is not used). 


folan] 


Specifies the number of 512-word system overlay areas to 
be created. The value for olan must be a decimal integer 
from 2 through 99. The default value is 1, indicating 
one 512-word area to be used for system overlays. 


[tsa] 


Specifies the number of trap save areas to be created in 
addition to the default number of 6 (system without com- 
munications), 7 (LAF system with communications), or 8 
(SAF system with communications). 


The size of each additional trap save area is the same as 


the size of each of the default trap save areas (viz., 64 
words in a SAF system and 104 words in a LAF system). 
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SYS 


You have the option of expressing this parameter sym- 
bolically by defining it with a VARIABLE directive. See Pa 
the description of the VARIABLE directive elsewhere in  % 2 
this section. | 


firb] 


Specifies the number of intermediate request blocks to be 
created in addition to the default number of 20 for the 
system. Each intermediate request block is 8 words in a 
SAF system and 13 words in a LAF system. 


You have the option of expressing this parameter sym- 
bolically by defining it with a VARIABLE directive. See 
the description of the VARIABLE directive elsewhere in 
this section. 


[E] 
Specifies that expanded error meSsages (text in addition 
to code) are to be issued. If this argument is omitted, 
only the error code is issued. 
Once this argument is specified, it remains in effect for 
the duration of the configured system, even if subsequent 
SYS directives appear with this argument ndall. 
This argument is not meaningful if the system is boot- 
strapped from diskette; space limitations on diskette 
prevent the presence of the error mesSage library file 
(EMLFILE). 


Functional Description: 
The SYS directive defines a number of system variables. If 


all of the SYS directive's default values are acceptable, it 
can be omitted. These default values are summarized below. 


Hz - 60 Hz line frequency 
scan_cycle - 50 milliseconds 


SSIP/DSIP/CIP/SCIP - null (no SIP simulator or commercial 
Simulator required) 


olan - 1 system overlay area 
tsa - 7 trap save areas 
irb - 20 intermediate request blocks 


E - error code only, no text 
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If multiple SYS directives are specified, only the last one 
is effective; exceptions: (1) all trap save areas and 
intermediate request blocks specified on all SYS directives 
are added to the system defaults of 7 and 20, respectively, 
and (2) if E is specified in any SYS directive, expanded 
error messages (text in addition to code) will be issued. 


SAS 


The size of the interrupt save area (and hence the size of 
the task control block, which includes the interrupt save 
area) depends on the CPU Model and SIP/CIP characteristics as 
Shown in Table 5-9. 


Table 5-9. Decision Table for Calculating TCB Size, Based 
on CPU Model and SIP/CIP Characteristics 


Conditions: 


Model 23, 33, or 6/34 et ee 
Model 43, 47, 53, Y| Y YY 
or 57 


SIP hardware present? ERG 
TPERE ale EER 


Model 47 or 57 BODEES 
Null aroument? eee | 
SSIP argument? Beer 
DSIP argument? Es idiecle eae ‘a 
CIP argument? ae eReee 
SCIP argument? Pee teeial 

x 


Resultant ISA Type: 


Basic ISA 


ttt debedet TT | TT 
X| X 


+ Model 40 and 50 
registers 


+ CIP context 


+ SIP context 


TCB Size, Based on ISA Type 


SAF Size LAF Size 
ISA_ Type (words) (words) 


Basic ISA 64 Not applicable 


+ Registers 64 96 


+ CIP Context 96 96 


+ SIP Context 96 128 


Entry meanings: Y - yeS N- no X - ISA type 


The basic ISA ends with the Ml-register save word. 


The ISA for Model 43, 47, 53, or 57 registers includes the basic ISA, save words for the 
M2- through M7-registers, and save word(s) for the stack address register. 


The CIP context includes all elements in item 2, plus the CIP-specific context area of 
2 words (SAF) or 3 words (LAF). 


The SIP context includes all elements in item 3, 
13 words. 


plus the SIP-specific context area of 


All TCB sizes are rounded up to the nearest multiple of 32 words. 


5-73 CB23-03 


SYS 


Example: 


SYS 


ne oyOOLP 7-374 740 


This example defines the system variables as shown below. 
(Assume that only one SYS directive is used.) 


The system line frequency is 60 Hz (default). 


The scan cycle of the system's real-time clock is 25 


milliseconds. 


The single-precision SIP simulator (SIPSIM SP) will be 
loaded to process scientific instructions, unless the 


hardware Scientific 


Five system overlay 


Six trap Save areas 
communications). 


Twenty intermediate 
(default). 


Error codes will be 


Instruction Processor iS present. 
areas will be created. 


will be created (default if no 


request blocks will be created 


expanded to include message text. 
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VARIABLE DIRECTIVE 

Directive Name: VARIABLE 

The VARIABLE directive defines a single-character symbolic 
expresSion (chosen from the letters A through Z) that may be 


specified in certain CLM directive statements. 


Variables can define values for the fields in the SYS direc- 
tive representing additional trap save areas or intermediate 
request blocks, or memory pool sSizeS in a MEMPOOL directive. A 
variable must be defined by a VARIABLE directive before it can be 
specified in other CLM directives. 

Format: 

VARIABLE variable=expression 

Argument Description: 


variable 


A single character designation, upper case only, chosen 
from the letters A through Z. 


ex pression 


Any valid expression that defines the value of the 
variable. expresSion may equal any of the following: 


@e An integer having a value between -32767 and +32767. 


e KSR (Represents the total number of MDC-connected 
terminals finally configured using the KSR value) 


e CON (Represents the total number of MDC-connected 
terminals finally configured with the CON value) 


e TTY (Represents the total number of communications 
devices finally configured by DEVICE TTY directives) 


e VIP (Represents the total number of communications 
devices finally configured by DEVICE VIP directives) 


e ATD (Represents the total number of devices finally 
configured by DEVICE ATD directives) 
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@ expression, expression, 


Ne b+ 


An arithmetic combination of two expressions (chosen 
from this list) using addition (+), Subtraction (-), 
multiplication (*) or division (/). The value of an 
expression is always an integer; all fractional values 
are truncated, not rounded. For example, 5/3 will be 
passed to the system as having a value of one (1). 


e (expression, ) 


expression, is to be evaluated before being combined 
with any other expression term. The expression is 
always evaluated by the system as an integer; all 
fractional values are truncated, not rounded. For 
example, 5/3 will be passed to the system as having a 
value of 1. At each step of the evaluation of an 
expression, fractional values are truncated, i.e., 
this is strictly integer arithmetic. 


@ Ss aoa 


specifies a signed value, plus or minus, for the 
expression. Note that "+expression" has the same 
value as “expression". 


e x (where x is the name of an already defined variable) 


Variables may be used when specifying the number of trap save 
areas and intermediate request blocks in a SYS directive, or 
the size of a memory pool in a MEMPOOL directive. Using a 
VARIABLE directive, you can assign symbolic values for these 
fields that will be subsequently resolved by the system. By 
Specifying variables in SYS or MEMPOOL directives, the system 
builder creates a generalized CLM file that may be used by 


several similar but not identical hardware configurations. 


Example 1: 


VARIABLE A=TTY*3000 — 
MEMPOOL ,T1,A 
MEMPOOL S,,* 
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Note that in all cases, a variable must be defined in the CLM 
file before it can be used in subsequent directives. The 
variable A has been defined to be equal to the total number 
of TTY terminals finally configured, multiplied by 3000. In 
the MEMPOOL directive, A represents the 3000 words of memory 
that will be reserved for each TTY configured. The first 
MEMPOOL directive defines the name and size of the memory 
pool that has reserved 3000 words of memory for each TTY 
terminal. The second MEMPOOL directive allocates all 
remaining memory to the system memory pool. 


A TEVIEVA 


By defining memory pools with variables, the system builder 
can accurately account for as many or as few devices as are 
actually configured. He need not Know the channel number 
assigned to each device, the memory pool size, or the number 
of devices actually configured. The system assigns these 
characteristics accurately and automatically. 


Example 2: 


VARIABLE B=TTY*3 
VARIABLE C=TTY*2 
SYS ,gre727C07B 


In this example, two variables have been defined for the trap 
Save area and intermediate request block fields in the SYS 
directive. C is defined as the number of trap save areas 
that will be allocated for each TTY terminal, in addition to 
the default number. (The value of C equals twice the number 
of TTY terminals configured.) C specifies that each terminal 
will have two trap Save areas in addition to the default 
number. B is defined in the SYS directive as the number of 
intermediate request blocks that will be allocated for each 
TTY terminal, in addition to the default number. (The value 
of B equals three times the number of TTY terminals con- 
figured.) B specifies that each terminal will have 3 inter- 
mediate request blocks in addition to the default number. 
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Example 3: (Refer to comments on next page) 


Sample CLM File 


VARIABLE I=KSR+10 
SYS rereleTyys 
DEVICE DSK00,6,10,X'400' 
DEVICE DSKO1,7,11,0 
DEVICE FCD00,8,12,0 
DEVICE RCD00,9,12,0 
COMM 13 
DEVICE TTY01,14,14,0 
DEVICE TTY02,15,15,0 
DEVICE TTY03,16,16,0 

2 ) DEVICE TTY04,17,17,0 
TTY 14,14,0,0,300 
TTY 15,15,0,0,300 
TTY 16,16,0,0,300 
TTY 1751750407300 

3 VARIABLE Z=TTY*500 
MEMPOOL ,LO,Z 

4 ({ MEMPOOL S,,* 

QUIT 


VARIABLE T=TTY+VIP 
1 


Example 3 Comments: (Refer to the sample CLM file) 


a 


Variables T and I have been defined in VARIABLE direc- 
tives replacing constant values in the SYS directive. T 
equals the total number of TTY and VIP terminals con- 
figured. I equals 10 plus the number of KSR terminals 
configured. In the SYS directive, T replaces some con- 
Stant value in the trap Save area field; I replaces some 
constant value in the intermediate request block field. 
In this context, T specifies one additional trap save 
area for each TTY or VIP configured; I specifies that the 
number of additional intermediate request blocks equals 
10 more than the number of KSR terminals configured. 


A maximum of four TTY terminals may be configured, 
depending on the number of available channels (with 
asynchronous line adapters). All terminals have floating 
channel assignments and are configured in the order in 
which they appear in the CLM file. 


The variable Z is defined such that 500 words of memory 
are allocated for each configured TTY terminal. (2 
equals 500 times the number of configured TTY terminals.) 
In the MEMPOOL directive that follows, Z specifies that 
pool LO allocates 500 words of memory for each TTY con- 
figured. The size of pool LO could be 500, 1000, 1500, 
or 2000 words, depending on the final number of TTY 
terminals actually configured. 
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This MEMPOOL directive allocates all unreserved memory to 
the system memory pool. 
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SECTION 6 


CLM DIRECTIVES FOR A COMMUNICATIONS CONFIGURATION 


This section describes the CLM directives used to define the 
communications environment of the system software. Communica- 
tions CLM directives may be entered from the CLM USER file or 
from any file or device specified in a CLMIN directive. There- 
after, a system startup can be performed. 


If your installation includes communications (MLCP/DLCP- 
connected) devices, you should have the Communications Processing 
manual available for reference. 


The communications-related CLM directives cause the following 
functions to be performed: 


e Data structures (i.e., tables) are established correspond- 
ing to the communications hardware available to your 
system. 


e The following bound units are loaded into the central 
processor's main memory: 


- Communications supervisor and multiline/dual line com- 
munications processor (MLCP/DLCP) driver. 


- One or more line protocol handlers (i.e., TTY, VIP, 
ATD, STD, BSC, PVE, HASP, RCI, or user-written). 


e The following elements are loaded into the RAM (random 
accesS memory) of one or more Communications controllers: 


- Data set channel control program. 


- Channel control programs of one or more line protocol 
handlers. 


Table 6-1 Summarizes the communications-related CLM direc- 
tives, which are described in alphabetic order in this section. 
Table #-2 provides detailed information on physical devices sup- 
ported by various directives. 
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Table 6-1. Summary of Communications-—Related CLM Directives 
ACU Defines an Auto Call Unit and associates the ACU 
channel with a data communications channel. 
Optionally, provides one or more telephone numbers 


to be used in establishing a connection for the 
associated data communications channel. 


Directive Meaning 


ATD Identifies a station on a line serviced by the 
asynchronous terminal device (ATD) line protocol 
handler. 

BSC Identifies a station on a line serviced by the BSC 


(binary synchronous communications) line protocol 
handler. 


COMM Establishes the priority level(s) at which the 
P MLCP/DLCP interrupts the central processor. 

DEVICE Indicates that the designated communications 
station is to be accessible through the file system 
interface. 

EQLRN Defines multiple logical resource numbers (Il1rn's) 
for the same physical communications device. 

HASP Identifies a remote workstation services by the 
HASP protocol. 

H 3270 Identifies a station on a line serviced by the BSC 
3270 protocol. 

# 

LPHn Identifies the first (or only) station on a line 

serviced by a user-written line protocol handler. 


LPHDEF Indicates nonstandard table sizes for channels and 
Stations controlled by a user-written line protocol 
handler. 


MODEM Defines a nonstandard modem type. 


POLIST | Identifies the start of the p 


protocol handler. The line 
STDLN directive. 


Identifies a polled VIP emulator "station" on a 
line serviced by the VIP line protocol handler. 
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Table 6-1 (cont). Summary of Communications-—Related 


Directive 


RCI 


ROP 


STA POL 


STDLN* 


STATION 


OTTY 


TTY“ 


VDAM 


VROSY ° 


CLM Directives 


Meaning 


Identifies a remote batch terminal services by the 
RCI protocol. 


Indicates that a receive-only printer is connected 
to a station on a line serviced by the synchronous 
terminal device line protocol handler. The line is 
identified by an STDLN directive and the station is 
identified by an STD directive. 


Defines a sequence of station poll addresses to be 
added to the poll list of a line serviced by the 
synchronous terminal device (STD) line protocol 
handler. The line is identified by an STDLN 
directive. 


Identifies a station on a line serviced by the syn- 
chronous terminal device (STD) line protocol hand- 
ler. The line is identified by an STDLN directive. 


Identifies a line serviced by the synchronous 
terminal device (STD) line protocol handler. 


Identifies the second or subsequent station on a 
line serviced by a uSer-written line protocol 
handler. | 


Specifies the file characteristics of a device that 
is not a disk device or a unit-record device. 


Identifies a station on a line serviced by the TTY 
(teleprinter) line protocol handler. 


Incorporates the Display Formatting and Control 
software component in the configuration. 


Identifies a polled or nonpolled synchronous visual 
information projection (VIP) terminal on a line 
serviced by the VIP line protocol handler. Option- 
ally, identifies an ROP (receive-only printer) sta- 
tion on the same line. 


Identifies a PRU1001/1003/1005 device on a line 


serviced by the ATD line protocol handler. 
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Table 6-1 (cont). Summary of Communications-Related 
CLM Directives ies 


< y 
Directive | Meaning 7 


| vrty* 


v72002° 


Identifies a teletype-like device on a line serv- 
iced by the ATD line protocol handler. 


Identifies a VIP7200 or VIP7205 device on a line 
serviced by the ATD line protocol handler. 


“The ATD directive is intended as a replacement for the VROSY, 
VTTY, and V7200 directives. The protocol handler called by 
the ATD directive offers additional support capabilities 
e.g., block mode support of VIP7801/02 devices, support of the 
VIP7207 device) not offered by the line protocol handler 
called by the VROSY, VTTY, and V7200 directives. The VROSY, 
VTTY, and V7200 directives can still be used. 


bThe ATD directive or the V7200 directive must be specified if 
VIP7200 or VIP7801/02 terminals are to be used for forms 
processing using Honeywell's Display Formatting and Control 
Facility. | 


“The TTY directive and the ATD directive support asynchronous 
terminal devices. The line protocol handler called by the TTY 
directive supports the physical terminal only in teleprinter 
mode. The TTY line protocol handler does not provide block 
mode support of VIP7801/02 devices; neither does it provide 
Support for VIP7200 devices and VIP7801/02 devices in forms 
processing mode. (For these functions the ATD directive is 
required.) ATD line protocol handler does not provide the 
transparent I/O or single character mode functions of the TTY 
line protocol handler. 


“The STD directive and the VIP directive support synchronous 
terminal devices. The line protocol handler called by the STD 
directive offers additional support capabilities (e.g., 
support of VIP7804 and VIP7805 terminals) not offered by the 
line protocol handler called by the VIP directive. 
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Table 6-2. CLM Directives and Supported Communications Devices 


Directive 


ATD 


BSC 


HASP 


H3270 


Devices Supported 


7200 
7205 
7801 
7802 PRU 1001/1003/1005 
7207 TWU 1001/1003/1005 


Receive-only printers: 
PRU 1001/1003/1005 


Level 6 central processor 
IBM central processor 
IBM central processor 


: 


VE Level 6 central processor 


RCI 


STD 


VIP 


VROSY 


Level 66 host processor 


VIP 7700 VIP 7700R 
VIP 7705R VIP 7760 
VIP 7804 VIP 7805 


Receive-only printers: 


TN 300 
TN 1200 
PRU 1003/1005 


VIP 7200 
VIP 7205 
VIP 7802 
TWU 1001/1003/1005 


VIP 7700 VIP 7700R 
VIP 7705R VIP 7760 
VIP 7805 VIP 7804 


Receive-only printers: 


TN 300 ASR-33 
TN 1200 ASR-35 
PRU 1003/1005 
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Table 6-2 (cont). CLM Directives and Supported Communications 


V7200 VIP 7200 VIP 7801 
| VIP 7205 VIP 7802 
VTTY | ASR-33 KSR-33 
| ASR-35 


Devices 


You should observe the following rules for arranging 
communications-related CLM directives: 


Ls 


Cae 


The COMM directive must precede all other communications- 
related CLM directives. 


If an LPHDEF directive is used in association with a 
user-written line protocol handler, the LPHDEF directive 


must precede all related LPHn directives. 


If STATION directives are used in association with an 
LPHn directive (in cases where a user-written line pro- 
tocol handler drives more than one station per line), 
the STATION directives must immediately follow the 
related LPHn directive. 


The DEVICE directive should follow related LPHDEF, 
STATION, and LPHn directives and related POLIST, STAPOL, 
ROP, STDLN, and STD directives. 


If an ACU directive is used, the station whose Irn 
appears aS an argument in the ACU directive must be 
defined in the directive that immediately precedes this 
ACU directive. 


When polled VIP's are connected to a communications line, 
the VIP directives for the stations on the line must be 
consecutive. | 


When polled VIP emulator (PVE) stations are associated 
with a communications line, the PVE directives for all 
the stations on the line must be consecutive. 


The value.assigned to the communications interrupt level 
(by the COMM directive) is normally restricted to the 
range 7 through 57. At initial startup, the bootstrap 
device is assigned level 6 by the system. If the level 
assigned to the bootstrap device is changed to a lower 
level (higher number) by a DEVICE directive, the communi- 
cations interrupt level can be specified as 6. The level 
that is assigned to a communications device associated 
with a COMM directive is normally 8 through 58. 
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When an MLCP/DLCP operator console is configured, it must 
be assigned LRN 0. 


Configuring a line serviced by the STD line protocol 
handler requires at least the directives STDLN, STD, 
POLIST, and STAPOL. An STD line may also use a ROP 
directive. The following diagram illustrates the 
Sequence rules for STD directives. Brackets enclose 
optional directives. One set of these directives must be 
Specified for each line: 


STDLN must specify one for each line 

STD, | 

[ROP ] Specify one for each Ee eae one set for each 
station, if needed station on the line; all 


J must precede POLIST 


STD 2 

[ROP ] 

POLIST must specify one for each line 
STAPOL must specify one or more for 


each line; all STAPQL 
directives should be speciifed 
in the order in which stations 
are to be polled 


[DEVICE] (optional) specifies that the device will be 
accessible to the file system 


As a general rule, two line protocol handlers are allowed 
per MLCP/DLCP. 


The STTY command keyword format, as described immediately 
following the STTY directive, may be used as an alterna- 
tive to the STTY directive format in your CLM file. The 
STTY command format provides additional features not Sup- 
ported by the STTY directive format. For example, if you 
wish to specify a terminal as being automatically recon- 
nectable following a power failure or line drop, you must 
configure the terminal using the STTY command format in 
your CLM file. (For a complete description of this capa- 
bility, see Appendix D.) 


Fach directive for a communications device must reference 
a unique logical resource number (lrn). If you wish to 
specify multiple communications directives which refer- 
ence the same physical device, you should use the EQLRN 
directive. The EQLRN directive is described later in 
this section. 


TOPICS RELATED TO COMMUNICATIONS DIRECTIVES 
The following paragraphs describe: 


@e How to assign channel numbers to your communications 
devices, or, how to let the system dynamically assign 
Channel numbers 


@e How to modify a terminal's line length 


e How to let the system dynamically assign a terminal's line 
Speed 


@e The amount of resident code required for communications 
modules. 


You should review each of these topics before you create your 
CLM directive file. 


Assigning Channel Numbers 


Channel control programs are loaded into the MLCP on the 
basis of channel numbers you specify for communications devices. 
You should observe the following guidelines when assigning chan- 
nel numbers to your communications devices: 


a. As a general rule, no more than two line protocol hand- 
lers can be associated with a given MLCP. 


b. The MLCP with which a particular line protocol handler is 
associated is determined by the channel number(s) you 
enter for communications devices. The system checks the 
first six bits of the hexadecimal channel number you 
specify to determine LPH allocation. 


FCOO - FF80 first MLCP 

F800 - FB80 second MLCP 
This range of F400 - F780 § causes the third MLCP 
Channel numbers FOOO - F380 \ LPH to go fourth MLCP 
Specified for a ECOO —- EF80 { into fifth MLCP 
device ‘ ; 


e e 


Cc. Each channel number must be a 4-digit hexadecimal number 
ending in 00 or 80. Note that channel numbers lower than 
0400 are unavailable for communications devices. 


DYNAMICALLY ASSIGNED CHANNEL NUMBERS 
For MLCP/DLCP-connected devices, channel numbers may be 


dynamically assigned or "floated" in TTY, VIP, VROSY, VTTY, ATD, 
V7200, or DEVICE directives. Pa 
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Assigning zero channel numbers to directives in.the CLM file 
relieves the system builder of the need to Know the channel 
assignments for each installation that will receive a copy of the 
system software. 


For each communications device configured, you have the 
option of specifying a channel number in the appropriate direc- 
tive or allowing the system to dynamically assign or "float" 
channel assignments at the Startup time. To float a channel, you 
specify the channel number parameter in the appropriate directive 
with a single zero (0). The system then assigns directives with 
floating channels to the first available devices on the bus. 

Note that if you specify a floating channel and the system cannot 
locate an appropriate device, no error message is issued; the 
system ignores this directive. 


If your system includes device adapters but not associated 
devices, it is recommended that explicit channel numbers be 
assigned to all devices within the device class. 


Channel numbers are assigned aS soon as the first floating 
channel is encountered in the CLM file. To prevent devices with 
floating channels from inadvertently preempting devices whose 
Channel numbers are explicitly specified, all directives of a 
given type with explicitly specified channel numbers should pre- 
cede all directives of that type with floating channels in the 
CLM file. All active channels should have higher bus addresses 
than all inactive channels to prevent the system from inadver- 
tently assigning a device to an inactive channel. 


For MLCP/DLCP-connected devices, the first available channel 
with the highest bus address and appropriate channel adapter 
(asynchronous or synchronous) will be assigned to the first 
floatable channel in a communications directive, and so on. 


NOTE: Assigning floatable channels to communications devices 
is recommended only if all devices will be configured 
identically (if, for example, a system specifies that 
all asynchronous devices will be directly-connected 
VIP 7200's with identical line speeds, DEL characters, 
stop bits, and parity). The system cannot distinguish 
between different types of MLCP/DLCP-connected 
devices.' 


'The M4 SYSDEF program does not permit you to configure MLCP/DLCP 
connected devices with floating channel numbers. M4 SYSDEF 
requires the system builder to supply all channel numbers for 
communications devices. 
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If a system is configured with devices containing floatable 
channel numbers, the system builder may determine all channel 
numbers assigned by the system as Soon as possible after a system 
initialization. The system operator can issue the command 
STS -ALL to list each device and its channel number assignment. 


See Section 5 for an example illustrating the use of floating 
channel number assignments. 


Modifying Terminal Line Length 


The line length specified for a terminal or other input 
device at system building time overrides the command processor 
line length of 127 characters. For example, at a terminal con- 
figured with a line length of 80 characters, you cannot enter a 
continuous command line longer than 80 characters unless you type 
an ampersand (&) at the end of the line and then continue on one 
or more additional lines. You can alter the terminal's line 
length by using the set terminal characteristics (STTY) command 
(described elsewhere in this manual) after system initialization 
or by modifying the STTY directive in your CLM file. 


Terminal Line Speed Selection Capability (Asynchronous 
Terminals Only 


When you specify an ATD, TTY, LPHn, VTTY, or V7200 directive, 
you have the option of deferring selection of an asynchronous 
terminal's line speed (specified by the fifth parameter) until 
the terminal comes online. To defer selection of a terminal's 
line speed, you specify the fifth parameter as either 'HI' or 
'LO' in one of the above-mentioned directives. Choosing this 
option frees you from specifying an exact line speed for every 
asynchronous terminal in your configuration. The interactive 
system building program, M4 SYSDEF, incorporates this deferred 
speed selection capability. — 


In order to allow the system to determine the terminal's line 
speed, the operator presses the RETURN key on the terminal's key- 
board when the terminal comes online. If, after several seconds, 
normal terminal operations have not begun, the operator should 
check for one of the following problems: 


1. The terminal's line speed may not be within the range 
Specified in the appropriate CLM directive. The operator 
may be able to adjust the terminal's line speed to fall 
within the r-nge specified by the directive. The opera- 
tor should then press the RETURN key. If, however, the 
terminal's line speed is fixed, adjustments must be made 
to the appropriate CLM directive. You may be required to 
change the designation of the terminal's line speed in 
the appropriate CLM directive. 


1'I£f you choose this option, an Auto Call Unit must not be config- 
ured for the terminal. 
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; 2. If the carriage return character was garbled and the sys- 
( ; tem could not determine the line speed of the terminal, 
the operator should press the RETURN key again. 


3. If the terminal's modem has gone offline, the operator 
must dial up the line again. 


If the system fails to receive a character transmission 
within 60 seconds, the terminal will be disconnected. 


Resident Code Requirements for Communications Modules 


The following table defines the number of words of resident 
code required for various communications modules; the table also 
lists the memory required in the MLCP/DLCP for associated channel 
control programs (CCP's). Memory requirements for noncommunica- 
tions modules are defined in Section 5. 


Table 6-3. Communications Memory Requirements 


Resident Resident MLCP Memory |DLCP Memory 

Memory Memory Required for|Required for 

(SAF) (LAF) CCP 
Component (in words)]| (in words) 


TTY Line 
Protocol Handler 


VIP Line 2.4K 2.5K 
Protocol Handler 


BSC Line 2.0K 2.0K 1100 EBCDIC 
Protocol Handler 817 ASCII 
PVE Line 2.3K 2.3K 

Protocol Handler 

RCI Line 2.0K 2.0K 

Protocol Handler 


| ATD Line 
Protocol Handler 
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Table 6-3 (cont). Communications Memory Requirements 


Resident Resident 
Memory Memory 
| (SAF) (LAF) CCP 
Component (in uc (in words) (in bytes) 


STD Line 

Protocol Handler 

3270 Line 2.1K 
Protocol Handler 


Note: Sizes do not include patch space sizes. 
only required as patches are added. 


Patch space is 


'2942 bytes of RAM memory are available in the MLCP for the load- 
ing of channel control programs. Any combination of the various 
CCP's can be loaded into the MLCP provided the total memory does 
not exceed 2942 bytes. | 


*3844 bytes of RAM memory are available in the DLCP for the load- 
ing of channel control programs. Any combination of the various 
CCP's can be loaded into the DLCP provided the total memory does 

not exceed 3844 bytes. 
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ACU 


ACU DIRECTIVE 


Directive Name: ACU 


The ACU directive identifies an Auto Call Unit and associates 
the ACU channel with a data communications channel. The ACU 
directive must immediately follow the directive describing 
the station whose lrn is specified in the ACU directive. The 
ACU directive cannot be associated with any data communica-— 
tions channel that Supports the speed select option. 


The ACU directive permits the addition of telephone numbers 
to a list of numbers maintained for a data communications 
channel. The list of telephone numbers for a data communica- 
tions channel can be unlimited and has the following format: 


Entry 0 empty (initially) 
[Entry 1 phone number 1] 
[Entry 2 phone number 2] 
[etc.] 


The Auto Call Unit dials each number in the list three times 


at 40-second intervals until the list is exhausted or a con- 
nection is made. 


The first ACU directive that relates an Auto Call Unit to 
this data communications channel causes an empty entry 0 to 
be established; this entry in the list may be loaded and 
reloaded, as desired, by means of an SDL (set ACU telephone 
number) command or SSDL macro call. The first ACU directive 
also creates an entry in the table (Starting with entry 1) 
for each telephone number (if any) Specified in the direc- 
tive. Any subsequent ACU directive relating the same ACU 

to the same data communications channel causes one or more 
additional entries to be added to the list; the additional 


entries are added to the end of the list in the order in 


which the telephone numbers appear in the ACU directive. 


Format: 


ACU Ilrn,level,X'acu_channel'[,'phone #1'[,'phone #2'[,...]]] 
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ACU 


Argument Description: 
Irn 


The logical resource number of any station on the data 
communications channel with which this Auto Call Unit is 
associated. 


level 


The priority level of the station whose Irn appears in 
the Irn argument of this directive. 


X'acu_ channel’ 


A 4-digit hexadecimal number (from X'0400' to X'FF80') 
Specifying the channel number of the Auto Call Unit. 


Bits 0 through 9 - The 10-bit channel address of the send 
or recieve channel on the line. 


Bits 10 through 15 - Must be set to zero. 
['phone #n"] 


tring of 1 to 16 ASCII characters chosen from the set 


Strin 
123 45 678 9 - (Separator) * #. 


FUNCTIONAL DESCRIPTION: 


n ACU directive causes the Auto Call Unit to initiate a line 
connection with a remote auto answer data set. When the 
software issues a connect order and bit 2 of the IORB is set 
to one, the Auto Call Unit attempts to dial a line using the 
list of telephone numbers established at configuration time. 
The Auto Call Unit dials each number in the list three times 
at 40-sSecond intervals until a connection is made or the list 
is exhausted. 


Example: 
TTY 26,8,X'FCOO' 
ACU 26,8,X'FDO0O','1-555-240-0281' 


In this example, an Auto Call Unit on channel FDOO is asso- 
ciated with the data communications channel (FC0O0) Servicing 
a TTY whose logical resource number is 26 and whose priority 
level is 8. Since this is the first ACU directive for this 
Auto Call Unit, the telephone number in the ACU directive is 
established as entry 1 in the list of telephone numbers for 
the indicated data communications channel (FC00). Note that 
the ACU directive immediately follows the TTY directive that 
describes the station whose Irn appears in the ACU directive. 
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ATD 


ATD DIRECTIVE 


Directive Name: ATD 


The ATD directive identifies a station on a line serviced by 
the asynchronous terminal device line protocol handler. This 
directive is used to configure asynchronous terminals as part 
of the communications system. The ATD directives must follow 
the COMM directive in the CLM file. You can float the chan- 
nel number assignments in this directive, if you wish. 


Format: 


ATD lrn, level,X'channel',[modem] ,[speed],['device-type' ] 
[del] ,{[stop-bit] [,parity] 
Argument Description: 


lrn 


The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


level 


The priority level at which the ATD line protocol handler 
processes requests for an input/output operation to the 
Station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci- 


fied in the COMM directive. 


X'channel' 


You may specify a single zero (0) to float this channel 
assignment or a four-digit hexadecimal number (from 


X'O040n' to X'FF8n'), that specifies the channel number of 
the station and the interrupt priority level (n) of the 


line. The channel number has the following format: 
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Bits 0 through 9 - The 10-bit channel address of the send 
or receive channel on the line. 


Bits 10 through 13 - Must be set to zero. 


Bits 14 and 15 - Specifies n, the priority level at which 
a communications line interrupts the 
central processor. mn may have a value 
of 0,1,2, or 3 aS Specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


[modem] 


A number specifying the type of data set. Possible val- 
ues are as follows: 


O0O - Direct Connect. 


1 - Bell 1xx-type modem (103A, etc.). Both data-set- 
ready and carrier-detect signals are required for a 
connection; absence of these signals is a 
disconnection. 


3 or greater - User-defined modem type (see "MODEM 
Directive," earlier in this section). 


The default value is modem type l. 


[speed] 


The data rate in bits per second. 


For an asynchronous line with a communications-pac whose 
id is 2108, , use one of the following values for speed: 


50 300 2400 
715 600 3600 
(default) 110 900 4800 


134 1200 7200 
150 1800 9600 


For an asynchronous line with a communications-pac whose 


id is 2100,,, 2110,,, or 2118,, , use one of the following 
values for speed: | 


50 200 1800 
75 300 2000 
(default) 110 600 2400 


134 1050 4800 
150 1200 9600 


NOTE: ‘TE the data rate is 134.5, specify 134. 
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You have the option to defer selection of the line speed 
until the terminal comes online. You select this option 
by specifying HI or LO. 


'HI' 
Specifies that all terminals associated with this 


line will be permitted to function only at speeds 
from 1200 through 9600 bits per second. 


‘ro! 


Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 110 through 1200 bits per second. 


For more information about the line speed selection capa- 
bility, refer to the discussion under "Topics Related to 
CLM Directives" near the beginning of this section. 


['device-type' ] 


Specifies the type of terminal used. If this argument is 
not specified, the default is TTY. Possible values are: 


Value Physical devices supported 
7200 VIP 7200, VIP 7205 


7801 VIP 7801, VIP 7802 
D7200 VIP 7207 


PRU PRU 1001, PRU 1003, PRU 1005, 
TWU 1001, TWU 1003, TWU 1005 


TTY An asynchronous terminal 
that 1S to be supported as 
teleprinter-compatible 


[del] 


In TTY mode, a head-of-form sequence (pre-order control) 
consisting of three LF's and the number of DEL characters 
Specified by this argument is generated if the following 
conditions are met. (If the conditions are not met, no 
head-of-form sequence is generated.) : 


e The first byte of the application's buffer must 
be designated as a control byte; i.e., bit 4 of 
the IORB's device specific word (I DVS) must be 
set to 0 at write time. | 
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e The control byte must specify that a head-of-form 
Sequence is to be generated; i.e., bit 3 of the Zu 
control byte must be set to l. 


@e Device type PRU is not specified. If it iS speci- 
fied, a true head-of-form is issued. 


In the field or TTY modes, an LF in an end-of-message 
sequence (post order control) is followed by the number 
of DEL characters specified by this control argument. 


The EOM sequence is controlled by the B- and C-bits of 
the IORB's device-specific word I DVS, as specified by 
the application at write time. The TTY line protocol 


handler sends an EOM sequence according to the following 
B- and C-bit values: 


I_DVS Bits 


| Oo 
Q 


KOM Sequence 


CR 

None 

CR,LF,DEL characters 
LF,DEL characters 


ek © © 
hrm OF © 


At read time, the application can specify the same B- and 
C- bit values in order to send an EOM sequence back to 
the terminal when the message is successfully received. 


Note that an LF character in a pre-order control speci- 
fied by the I_CON word of IORB is never followed by a 


DEL character, i.e., this control argument has no effect 
in this case. 


This argument allows you to select 1 to 32 DEL char- 
acters. The default for each type of device is as 
follows: 


Device-Type Number of DEL Characters 


7200 
7800 
PRU1001/1003/1005 
TTY 


~~ © © 


-- 


[stop-bit] 


Specifies the number of stop bits that are to follow each 
character. A value of 1 or 2 can be chosen for each 
device. Default values are as follows: 
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Number of Stop Bits 
1 


GQLV 


(For speeds greater 
than 110 bits per second) 


Z 


(For a speed of 110 bits 
bits per second or less) 


[parity] 


Specifies the type of parity ("ODD" or "EVEN") to be 
used. The default is EVEN. 


Example: 
ATD 15,17,X'F800',0,150,'7200' ; 
In this example a VIP 7200 terminal is connected to a line 


serviced by the ATD line protocol handler. The device 
defaults for del, stop-bit, and parity are assumed. 
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BSC DIRECTIVE 


Directive Name: BSC 


The BSC directive identifies a station serviced by the binary 
Synchronous communications line protocol handler.! 


Format: 


BSC lIrn,level,X'channel',[modem],[primary/secondary], 
[character set][,multi_ block count] 


Argument Description: 


lrn 


The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 252. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


level 


The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
Station. The value for level is an integer from 7 
through 62; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci- 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 


1ITf the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be "paired" with 
the BSC directive (see "DEVICE Directive,” later in this sec- 
tion). If input/output to the station is to be asynchronous, 


the B (buffered) argument must be included in the DEVICE oN 
directive. 
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X'channel' 


A four-digit hexadecimal number (from X'040n to X'FF8n'), 
specifying the channel number of the station and the 


interrupt priority level (n) of the line. The channel 
number has the following format: 


Bits 0 through 9 —- The 10-bit channel address of the send 
or receive channel on the line. 


Bits 10 through 13 - Must be set to zero. 


Bits 14 and 15 - Specifies n, the priority level at which 
a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


[modem] 


A number specifying the type of data set. Possible 
values are as follows: 


O - Direct connect. 


2 - Bell 2xx-type modem (201A, 208B, etc). The data-set- 
ready signal is needed for a connection; absence of 
this signal is a disconnection. 


3 or greater - User-defined modem type (see "MODEM direc- 
tive," later in this section). 


The default value iS modem type 2. 


[primary/secondary] 


Values may be specified as P or S; indicates whether this 
is a primary or secondary endpoint of the transmission. 


A primary endpoint (the default) has priority in conten- 
tion mode. 


[character-set] 


One of the following may be specified: 
AS ASCII (the default). 
EB EBCDIC. 


The user is responsible for using the correct character 


set. The BSC protocol does not perform character 
translation. 
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od 


©) 


BSC 


[multi block count] 
An integer from 1 to 7 specifies the maximum number of 
data blocks for a single transmission in multi-block 
mode. The default is that multi-block mode is not used. 
Example: 
BSC 29,6,X'FDO0O',2,S,EB 
DEVICE BSCO00,29,6,X'FDO00',HOST,,B 
In this example, line FDOO is used for communications with 
another computer. Modem type 2 is used for the line. The 
Level 6 computer is the secondary endpoint on the line. A 


file system interface is established for the station by the 
DEVICE directive. Multiblock mode is not used. 
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COMM DIRECTIVE 


Directive Name: COMM 


The COMM directive is mandatory in a system that includes 
communications. It specifies from one to four priority 
levels at which communications lines can interrupt the cen- 


tral processor. The COMM directive must precede all other 


communications-—-related CLM directives. 


Format: 


COMM level 0 [,[level_1][,{level_ 2][,[level 3]]]] 
Argument Description: 


level 0 

[level 1] 
[level 2] 
[level 3] 


The four possible priority levels at which a communications 
line interrupts the central processor. At least one priority 
level must be specified. Values for level 0 through level 3 
must be in the range of 7 through 61 and must not duplicate | 
any other non-communications device priority levels. Each 
value chosen for level 0 through level 3 must be greater or 
equal (have a lower or equal priority) to the preceding 
level. tThe default values for level 1 through level 3 are 
equal to the value assigned to the next highest priority 
level (level (n-1)). For example, if a priority value has 
not been assigned for level 2 in a COMM directive, the 
priority value specified for level _1 is assumed. (See the 
third TTY directive in the example that follows.) 


Functional Description: 


The COMM directive specifies from one to four priority levels 
at which communications lines can interrupt the central pro- 
cessor, as described above. 


The interrupt level for a communications line is speciifed 
by the values of bits 14 and 15 of the channel number argu- 
ment in the directive that identifies the line. Bits 14 
and 15 correspond to the positions of the level _n arguments 
specified in the COMM directive. 


6-23 CB23-03 


COMM 


Example: 


priority 
(interrupt) 
level 

COMM 10, ll 

TTY 20,20,X'FFOO',... level 0 10 

BSC 21,21,X'FCO1',... level 1 at 

BSC: 22522;,%" FC81" p< level 1 11 


In this example, three line protocol handlers are configured. 
The TTY associated with lrn 20 processes interrupts on level 

10; the BSC station with lrn 21 processes interrupts on level 
ll, as does the BSC station with Irn 22. 
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DEVICE DIRECTIVE 


Directive Name: DEVICE 


The DEVICE directive is required for a communications station 
only if it is to be accessible through the file system inter- 
face. In this case, the DEVICE directive must be "paired" 
with the appropriate station-defining directive (1.e., TTY, 
ATD, STD, VIP, BSC, PVE, HASP, or RCI) so that each pair con- 
tains the same lrn, level, and channel number. You may float 
Channel numbers, if you wish. The DEVICE directive should 
follow related LPHDEF, STATION, and LPHn directives and 
related POLIST, STAPOL, ROP, STDLN, and STD directives. 


You must include a special format of the DEVICE directive in 
your CLM file if your installation will use a dual-purpose 
operator terminal. Refer to "Configuring a Dual-Purpose 
Operator Terminal" in Section 5. 


Format: 


DEVICE device _unit,1lrn,level,X'channel',[device name], 


B 
[record size] |,)N 


Argument Description: 
device unit 


A string of up to six ASCII characters; the first three 
or four characters identify the type of station and the 
last character (alphanumeric) identifies one specific 
Station of that type. The permissible values of device 
unit are as follows: ~ 


TTYnNn 
BSCnn 
XBSCnn 
VIPnn 
PVEnn 
ROPnn 
ATDnn 
STDnn 
HAS Pnn 
RC Inn 
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The default characteristics of various types of stations are 
given below. Some of the default characteristics are specified 
by the default value of the device specific words (dsw). Certain 
default characteristics for any station in the configuration can 
be changed by use of the CLM directive STTY which is described 
later in this section. The description of the STTY directive 
includes an explanation of the device specific words. 


In addition, a user can override (temporarily change) certain 
default characteristics of a station he is using by the system 
command STTY or the macro call SSTTY. 


TTYnNn 
@e Record size: 73 bytes (including control byte) 
@e Device specific word for connect/disconnect = 0 
- No autodial used 


- Hang up phone on disconnect 
- Queue abort 


@e Device specific word for read/write = 0030 
(hexadecimal) 


- Trailing carriage return 
- Trailing line feed 
- Echo mode 
- Leading control byte 
e Detab is ON 
e Input is asynchronous 


e Output is asynchronous 


e Type is bidirectional 


e BSC 2780 protocol 
@e Record size: 137 bytes (including control byte) 
e Device specific word for connect/disconnect = 0 
- No autodial used 
- Hang up phone on disconnect 
- Leading control byte 


- Queue abort 
- Buffer mode is single record 
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ei 


XBSCnn 


Device specific word for read/write = 0000 
(hexadecimal) 


- Leading control byte 

Detab is OFF 

Input is nonbuffered synchronous 
Output is nonbuffered synchronous 


Type is input only between connects or output o 
between connects 


BSC 3780 protocol 


nly 


Record size: 137 bytes (including control byte) 


Device specific word for connect/disconnect = 0 


- Hang up phone on disconnect 
- Queue abort 


Device specific word for read/write = 0040 
(hexadecimal) 


- Leading control byte 
Detab is OFF 

Input iS asynchronous 
Output is asynchronous 


Type is bidirectional 


Record size: 81 bytes (including control byte) 


Device specific word for connect/disconnect = 0 
(hexadecimal) 


- Logical read time-out interval is 10 minutes 
- No autodial is used 
- Home cursor on page overflow 


- Leading control byte 


100 
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DEVICE 


PVEnn 


- Poll interval of one second (ignored if nonpolled 
VIP) 


- Hang up phone on disconnect 
- Queue abort 


- Do not save function codes in read IORB (Input/ 
Output Request Block) 


Device specific word for read/write = 0010 
(hexadecimal) 


- Trailing carriage return 
- Trailing line feed 


- Input/Output is asynchronous 
- Type is bidirectional 


Record size: 81 bytes (including control bytes) 
Device specific word for connect/disconnect = 0 
- No autodial is used 

- Do not save function codes in read IORB 

- Hang up phone on disconnect 

- Queue abort on disconnect 

Device specific word for read/write = 0 

Detab is ON 

Input is asynchronous 


Output is asynchronous 


Type is bidirectional 


Record size: 73 bytes (including control byte) 
Device specific word = 0000 (hexadecimal) 

- Trailing carriage return 

- Leading control byte 

- Physical disconnect 

- Queue abort 

Detab is ON 


Input iS asynchronous 


Output is asynchronous 
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Type is output 


SADIAAG 


Record size: 73 bytes 

Device specific word for connect/disconnect = 0 
- No autodial is used 

- Hang up phone on disconnect 


- Queue abort 


Device specific word for read/write = 30 (hexadecimal) 


- Echo input character (echo mode) 
- Line feed at end of message (EOM) 


Detab is ON 
Input is asynchronous 
Output is asynchronous 


Type is bidirectional 


Record size: 81 bytes 


Device specific word for connect/disconnect = 103 
(hexadecimal) 


- No autodial is used 

- Home cursor on page overflow 

- Leading control byte 

- Logical poll interval = 1 second 
- No space suppress 

- No roll 


- Hardware function codes are specified in write 
requests 


- No timeout on read requests 


- Send DLE EOT (Data Link Escape; End of Trans- 
mission) (7804) on disconnect 


- Hang up phone on disconnect 


6-29 CB23-03 


DEVICE 


- Queue abort 


@e Device specific word for read/write = 10 (hexadecimal) 


- Carriage return at end of message 
- Line feed at end of message 
- Print one copy (7804) 


HAS Pnn 


@e Record size: 520 bytes (including control bytes) 
@ Device specific word for connect and disconnect = 0000 
(hexadecimal) 


- Queue abort 
- Hang up phone on disconnect 


@e Device specific word for read/write = 0100 
- Leading control byte 


@e Detab is ON 

@e Input is synchronous 
@e Output is synchronous 
e Type is bidirectional 


@e Record size: 132 bytes (including control byte) 
@e Device specific word for connect and disconnect = 0003 


- Do not hang up phone on disconnect 
- No queue abort 


@e Device specific word for read/write = 0100 


- Do not quit upon receiving break 
- Leading control byte 


Detab is ON 

Input is synchronous 

Output is synchronous 
Type is bidirectional 


The logical resource number of the station identified by 
the ATD, STD, TTY, VIP, BSC, PVE, HASP, or RCI directive 
with which this DEVICE directive is "paired." (A ROP is 
identified in a VIP directive.) The value of lrn is an 
integer from 3 through 255. 
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level 


The priority level of the station identified by the ATD, 
STD, TTY, VIP, BSC, PVE, HASP, or RCI directive with 
which this DEVICE directive is “paired." 


The value for level is an integer from 7 through 61; it 
may be the same as the level specified for other communi- 
cations stations, but it must be a higher number than the 
communications interrupt level(s) specified in the COMM 
directive. The level specified for one or more communi- 
cations stations may not also be used for noncommunica- 
tions devices or tasks. 


X' channel' 


The channel number of the station identified by the ATD, 
STD, TTY, VIP, BSC, PVE, HASP, or RCI directive with 
which this DEVICE directive is "paired." Bits 10 through 
15 of the channel number specified in a DEVICE directive 
Should equal 0 even though they may not equal 0 in the 
"paired" directive. Bits 15 and 16 of the channel number 
Specified in a DEVICE directive do not indicate the 

interrupt level of the communications line. You can 
float this channel assignment by specifying a single zero 
(0), if you wish. 


[device name] 


A string of 1 to 12 ASCII characters, the first of which 
must be alphabetic. This device name is a unique name by 
which the station can be referred to within the file 
system. If a device name is not specified, the device_ 
unit argument is used as the device name. 


[record_size] 


The length, in bytes, of one physical record. If record _ 
size is not specified, the default record size is as 
established by the device unit argument. 


i 


For normally unbuffered stations (viz., BSC, HASP, RCI), 


B indicates that input/output to the station is to be 
buffered. 


For normally buffered stations (viz., TTY, VIP, PVE, 


ROP), N indicates that input/output to the station is to 
be unbuffered. 
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For TTY, VIP, ROP, PVE, ATD, and STD stations, the 
default is buffered. For HASP, RCI, BSC, and XBSC sta- 
tions, the default is unbuffered... 


Input/output to a buffered station may be asynchronous 
or synchronous. Input/output to an unbuffered station 
is always synchronous; tabulation characters are not 
expanded. | | 


For a BSC 3780 (XBSC) station, input/output must be 
asynchronous. Therefore, this argument must not be 
Specified aS N for an XBSC station. 

For the following station types: 


TTY 
VIP 
PVE 
ROP 
ATD 
STD 
HAS P 
RCI 


tabulation characters are normally expanded into space char- 
acters. Tabulation characters are not expanded if N is 
specified for these station types. Tabulation characters are 


never expanded for BSC or XBSC station types. 


Functional Description: 


If a communications station is to be accessible through the 
file system interface, the station's TTY, VIP, ATD, STD, BSC, 
PVE, HASP, or RCI directive must be “paired" with a DEVICE 
directive. The lrn, level, and channel numbers for each pair 
of directives must be identical. (Note that this requirement 
applies to an MLCP/DLCP-connected operator terminal.) 


Multiple DEVICE directives that specify the same lrn and 
level are invalid. The EQLRN directive (described elsewhere 


in this section) allows you to equate multiple Irn's for a 
device. 


Example 1: 

TTY 21,8,X'FF80',,300 

DEVICE TTY00,21,8,X'FF80',TTYFILE 
In this example, a TTY is to be accessible through the file 
System interface. The DEVICE directive contains the same 
lrn, level, and channel number as the TTY directive. The 


default characteristics of the station are shown under the 
device unit argument above. The default record size (73 
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bytes) is also to be used since no record size argument is 
specified in the DEVICE directive. The device name TTYFILE 
is to be used for references to the station within the file 
system. 


Example 2: 


SYS isnoce aces 


STDLN 10,X'FFOO',2,2400,W4 | 
STD 20,0,V7805 . 

ROP ROSY 26 

STD 21,1,V7804 

STD 22,2 | 
POLIST 2 : 
STAPOL 0,1,0,2 

DEVICE STDOO,20,10,X'FF00',V7805,80,B | + 
DEVICE STDO02,21,10,X'FF00',V7804,80,B 

DEVICE STD03,22,10,X'FF00',V7700,80,B 


In this example, three synchronous devices are to be access- 

ible through the file system interface. DEVICE STDOO, 

DEVICE STDO2, and DEVICE STDO3 directives are paired with the 
first, second, and third STD directives in the CLM file. 

Note that each DEVICE directive has the same lrn, level, and 

channel number as specified in its paired STD directive. 


DEVICE directives may appear anywhere in your CLM file. * 
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EFOLRN DIRECTIVE 


Directive Name: EQLRN 


The EQLRN directive allows you to specify multiple logical 
resource numbers (lrn's) for the same physical device. 
Although each device in a communications configuration must 
be assigned a unique lrn, the EQLRN directive permits you to 


"equate" two or more lrn's to reference the same physical 
device. 


Format: 
EQLRN Irn,,1rn,[,lrng,,...] 
Argument Description: 


lrn, 


The primary logical resource number associated with the Sw 
physical device. This argument must be specified. 


Irn, 


The secondary logical resource number(s) that will be 
associated with the device being referenced by lrnp. You 
Must specify one or more lIrns arguments. Values you 
specify for lrng must be numerically less than the 
largest lrn used in a communications DEVICE directive or 
any other communications directive. 


The following example illustrates one possible applica- 
tion of the EQLRN directive: 


A communications device can be driven with two different 
sets of device characteristics via the same user-written 
driver. Each different logical device is referenced by a 
unique file name. This requires two separate communica- 
tions DEVICE directives, each specifying a unique file 
name. The device characteristics are specified by STTY 
directives. 


The following set of CLM directives illustrate those 
directives which must be included at configuration time: Pa 
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LPH3 32,32,X'FF80',,4800 

DEVICE TTY05,32,32,X'FF80' ,CDROO, 80 
STTY CDROO,,X'0C00',,S 

DEVICE TTY06,33,32,X'FF80' ,CRP0O,80 
STTY CRP00,,X'0800' , OFF 

EQLRN 32,33 


ATD 35,35,X'FFOO',0,9600,'7200' 
DEVICE TTY07,35,35,X'FFO0',,,N 


« 


Note that the last two directives above specify an lrn that 
is numerically larger than those specified in the EQLRN 
directive. The lrn's specified in the EQLRN directive must 
be numerically less than the largest lrn specified in any 


other communications directive. 
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HASP DIRECTIVE 
Directive Name: HASP 
The HASP directive identifies an IBM workstation on a line 
serviced by the HASP line protocol handler.' | 
Format: 
HASP Irn,level,X'channel' ,[modem] 
Argument Description: 
lrn 
The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 
level 
The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
Station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci- 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 
1If the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be "paired" with 
the HASP directive (see "DEVICE Directive", earlier in this sec- 
tion). If input/output to the station is to be asynchronous, _ 
the B (buffered) argument must be included in the DEVICE a 
directive. ee 
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( A four-digit hexadecimal number (from X'040n' to X'FF8n') 

| specifying the channel number of the station and the 
interrupt priority level (n) of the line. The channel 
number has the following format: 


Bits 0 through 9 - The 10-bit channel address of the send 
or receive channel on the line. 


Bits 10 through 13 —- Must be set to Zero. 


Bits 14 and 15 - Specifies n, the priority level at which 
a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


[modem] 


A number specifying the type of data set. Possible 
values are as follows: 


0 - Direct connect. 
2 - Bell 2xx-type modem (201A, 208B, etc.). The data- 


set-ready signal is needed for a connection; absence 
of this signal is a disconnection. 


3 or greater - User-defined modem type (see "MODEM direc- 
tive", later in this section). 


The default value 1S modem type 2. 
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H3270 DIRECTIVE 
Directive Name: H3270 


The H3270 directive identifies a station on a line serviced 
by the BSC 3270 line protocol handler. Only one station may 
be configured on a line. 


Format: 


H3270 I1rn,level,X'channel',{modem],X'poll address', 
X'select address' 


lrn 


The logical resource number associated with the station. 
The value of lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


level 


The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
Station. The value for level is an integer from 7 

through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci- 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 


X'channel'! 


A 4-digit hexadecimal number (from X'N40n' to X'FF8n'), 
specifying the channel number of the station and the 
interrupt priority level (n) of the line. The channel 
number has the following format: 


Bits 0 through 9 - The J0-bit channel address of the send 
or receive channel on the line. 


Bits 10 through 13 - Must be set to zero. 


Bits 14 and 15 - Specifies n, the priority level at which 
a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 aS specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


[modem] 


A number specifying the type of data set. Possible 
values are as follows: 


0 -— Direct connect. 
2 - Bell 2xx-type modem (201A, 208B, etc.). The data- 
set-ready signal is needed for a connection; absence 


of this signal is a disconnection. 


3 or greater - User-defined modem type (see "MODEM 
Directive," later in this section). 


The default value is modem type 2. 
X'poll address’ 


A 2-digit hexadecimal number (from X'00' to X'FF') 
specifying the poll address of the 3270 control unit. 


X'select address’ 


A 2-digit hexadecimal number (from X'00' to X'FF') 
specifying the select address of a 3270 device. 


Example: 
H3270 25,20,X'FCO0O0',2,X'60',X'40' 


In this example the host will use an address of X'60' to poll 
this station and an address of X'40' to select this station. 
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LPHn DIRECTIVE 
Directive Name: LPHn 


The LPHn directive identifies the first (or only) station on 
a line serviced by a user-written line protocol handler! 


Format: 


LPHn Irn,level,X'channel',[{modem],[speed], 
([FDX/HDX][,1lph specific word] 


In the directive name LPHn, n is an integer from 0 through 
3 and identifies a specific line protocol handler. If an 
~PHDEF directive is used in association with this line pro- 
tocol handler, the value of the lph argument in the LPHDEF 
directive must match n. | 


Argument Description: 


lrn 


The logical reSource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


level 


The priority level at which the communications Supervisor 
processes requests for an input/output operation to the 
Station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci- 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 


1The LPHn directive is also used in conjunction with the Remote ff 
Batch Facility. See Appendix F. 


ee, ee 


an 
& 
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A four-digit hexadecimal number (from X'040n' to 
X'FF8n'), specifying the channel number of the station 
and the interrupt priority level (n) of the line. The 
channel number has the following format: 


UHd | 


Bits 0 through 9 - The 10-bit channel address of the send 
or receive channel on the line. 


Bits 10 through 13 - Must be set to Zero. 


Bits 14 and 15 - Specifies n, the priority level at which 
a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 aS specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


[modem] 


A number specifying the type of data set. Possible 
values are as follows: 


O —- Direct connect. 
1 - Bell lxx-type modem (103A, etc.). Both data-Sset- ss 
ready and carrier-detect signals are needed for a 


connection; absence of both signals is a 
disconnection. 


2 - Bell 2xx-type modem (201A, 208B, etc.). The data- 
set-ready Signal is needed for a connection; absence 
of this signal is a disconnection. 


3 or greater - User-defined modem type (see "MODEM 
Directive," later in this section). 


The default value is modem type 2. 
[speed] 
The data rate in bits per second. 


For an asynchronous line with a communications-pac whose 
id is 2108, , use one of the following values for speed: 


50 300 2400 
75 600 3600 
(default) 110 900 4800 


134 1200 7200 
150 1800 9600 
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For an asynchronous line with a communications-pac whose 
id is 2100, , 2110... , or 2118 use one of the following 


16 4 
values for speed: 
50 200 1800 
75 300 2000 
(default) 110 600 2400 


134 1050 4800 
150 1200 9600 


NOTE: If the data rate is 134.5, specify 134. 


For asynchronous terminals you have the option to defer 
selection of the line speed until the terminal comes on- 
line. You select this option by specifying HI or LO. 


"HI' 


Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 1200 through 9600 bits per second. 


‘LO! 


Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 110 through 1200 bits per second. 


For more information about the line speed selection capa- 
bility, refer to the discussion under "Topics Related to 
CLM Directives" near the beginning of this section. 


[FDX/HDxX ] 


Specifies whether the line is full- or half-duplex. If 
it is full-duplex (FDX), two channel tables will be 
assigned. The default value is HDX. 


[lph_ specific word] 


A word containing user-defined information to be passed 
to the line protocol handler through the station table 
at offset ZQSSTS. The default is zero. 


Functional Description: 


The LPHn directive must be included once for each line (i.e., 
pair of channels) of an MLCP/DLCP on which there are stations 
to be driven by a usSer-written line protocol handler. An 
LDBU directive (described in Section 5) must be included 
among the CLM directives so that the Configuration Load Mana- 
ger will load the user-written line protocol handler bound 
unit and execute its initialization code. If the sizes of 
the channel and station tables are different from the default 
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Sizes for these tables, an LPHDEF directive must be included 
before the related LPHn directive(s). The values specified 
in the LPHDEF directive apply only to the LPHn and STATION 
directives that immediately follow the LPHDEF directive in a 
CLM file. 


If there is more than one station on a line driven by the 
user-written line protocol handler, the additional stations 
on the line must be identified by STATION directives that 
immediately follow the LPHn directive (see "STATION Direc- 
tive," later in this section). 


Example: 


LPHO 27,8,X'FD80',,,FDX 
STATION 28,1 


In this example, there are two stations on a synchronous, 
full-duplex line controlled by a user-written line protocol 
handler. 
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LPHDEF DIRECTIVE 
Directive Name: LPHDEF 


For each line protocol handler you write, you can include an 
LPHDEF directive to define the sizes of tables used for the 
channels and stations controlled by the line protocol han- 
dler. If the LPHDEF directive is not included, channel table 
and station table default sizes will be used for channels and 
Stations controlled by the line protocol handler (see 

channel table size and station_table size arguments below). 


Format: 


LPHDEF I1ph,[{channel table size] [,station table size] 
Argument Description: 
lph 


An integer from 0 through 3 that associates this LPHDEF 
directive with a line protocol handler identified in one 
or more LPHn directives. 


(channel table size] 


Specifies the number of words needed for the channel 
table and the CQB'S (communications queue blocks). It 
must have a value of at least 10 words. The default 
value is 33 words. 


[station table size] 


Specifies the number of words needed for this line pro- 
tocol handler's station table (resource control table). 
It must have a value of at least 10 words. The default 
value is 10 words. 


NOTE: The values specified for channel table size and 
Station table size apply only to the LPHn and 
STATION directives that immediately follow the 
LPHDEF directive in a CLM file. 
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LPHDEF 0,30 

LPHO 27,8,X'FD80',,,FDX 

STATION 28,1 
In this example, line FD80 has two stations on a synchronous, 
full-duplex line controlled by a user-written line protocol 
handler. Each of the two channel tables for the line has a 
size of 30 words, as defined by the channel table size argu- 


ment in the LPHDEF directive. The default value (10 words) 
is accepted for station table size. 
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MODEM DIRECTIVE 


Directive Name: MODEM 


The MODEM directive defines a nonstandard modem type. The 
information provided in this directive is used to test 


entries in the appropriate line control table of the MLCP/ 
DLCP to verify a connection or disconnection. 


The MODEM command has a connect featur 

e for some E an 
data sets that require data-terminal-ready to remain OW 
until the ring indicator is turned on. This feature is acti- 
vated by setting bit 7 of the data set control argument. 


Format: 


MODEM type _number,connection AND mask,connection_XOR_mask, 


qi cecancet ion _AND mask, disconnection _ XOR _ mask, 
data_ set_ control 


Argument description: 

type number 
An integer from 3 to 15 that is assigned to this modem 
definition and may then be used in a communications sta- 
tion directive (i.e., TTY, VIP, BSC, HASP, RCI, PVE, and 
LPHn directives). 

connection AND mask 
A 2-digit hexadecimal number whose value governs which 


bits (i.e., from 0 through 3) of line register 5 (LR5) 
will be examined when a connect request is processed. 


A 2-digit hexadecimal number whose value governs which 
bits (from 0 through 3) of LRS must be ON (i.e., set 
to 1) for a connection. 
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disconnection AND mask 


A 2-digit hexadecimal number whose value governs which 
bits (i.e., from 0 through 3) of LR5 will be examined 
when a disconnect request is processed or when a test for 
the occurrence of a disconnect is made. 


disconnection XOR_mask 


A 2-digit hexadecimal number whose value governs which 
bits (from 0 through 3) must be ON (i.e., set to 1) for 
a disconnection. 


data set control 


A 2-digit hexadecimal number loaded into byte 20 of the 
appropriate line control table (LCT). The contents of 
LCT byte 20 are loaded into line register 2 of the 
communications-pac when a line is to be connected. 


NOTES: l. To test for a successful connection, the contents 
of LR5 are first subjected to a logical AND 
operation against the (user-Supplied) connection _ 
AND mask; then a logical exclusive OR operation 
1s performed on the reSult of the first opera- 
tion, against the (user-supplied) connection XOR_ 
waSk. If the result is zero, a connection has 
been established. 


2. To test for a disconnect, the same operations are 
carried out using the analogous disconnection 
masks. A zero reSult indicates a disconnection. 


3. The following shows the mask and data set control 
values for the standard CLM-recognized modem 


types: 
Modem Type Connection Mask Disconnection Masks’ Data Set 
Type Number AND XOR AND XOR Control 
Direct 0 X'80' X'80' X'80' X'OO0' X'88! 
Connect 
Bell lxx 1 X'AO! X'AO! A'AO' X'OO0' X'80' 
Bell 2xx 2 X'80' X'80' X'80' X'OO! X'80' 


Line register 5 and byte 20 of the LCT are shown below. 
See the Communications Handbook for a detailed description] 
of these entities. 
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Line Register 5: 


DATA SET STATUS COMMUNICATIONS-PAC STATUS 


ASYNCHRONOUS ASYNCHRONOUS 
A 


DATA SET CLEAR CARRIER RING CHANNEL RECEIVE 
READY TO SEND DETECTOR INDICATOR RECEIVE RESERVED OVERRUN 


SYNCHRONOUS 


UNDERRUN 


LCT Byte 20: 


| commusicarionseaccowrnon, | -PAC CONTROL 


ASYNCHRON 

SeaONR eee 
or CHANNEL TRANSMIT 

: REQUEST TRANSMIT RECEIVE TRANSMIT 
TERMINAL neues 
READY SYNCHRONOUS 
SPEED —CS~S Bake 
: SELECT 


Example 1: 


MODEM 3,X‘'20',X'20',X'20,X'00',X'88' 
In this example, a modem type requiring only the carrier- 
detect signal for a connection and absence of this signal 
for a disconnection is defined. 
Example 2: 

MODEM 4,X'90',X'90,X'90',X'00',X'81' 


This example illustrates a MODEM directive for a European 


modem that is like a Bell Type 103, except for the relation- 


ship between data terminal ready and the ring indicator. 
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POLIST DIRECTIVE 
Directive Name: POLIST 


POLIST specifies the time interval between succesSive scans 
of the poll list. The POLIST directive must precede the 
poll list. 


Format: 
POLIST [poll cycle delay] 

Argument Description: 

[poll cycle delay] 
Defines the time interval in seconds between succesSive 
scans of the poll list. After completing a scan of the 
poll list the driver waits the specified time interval 
before re-scanning the poll list. If this parameter is 


Specified, it must be in the range of 1 to 10 (Seconds). 
If not specified, the default is 1 (Second). 
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PVE DIRECTIVE 
Directive Name: PVE 


The PVE directive identifies a polled VIP or STD emulated 
Station on a line serviced by the VIP or STD line protocol 
handler.!.2.3.4 


Format: 


PVE lrn,level,X'channel',[{modem],poll_ address[,poll response] 
[,controller poll address] 


Argument Description: 


lyn 


The logical reSource number associated with this station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


1PVE directives are used in configuring the system at the end of 

the communications line where polled VIP emulation is to be per- 
formed. The system at the other end of the communications line 

must be configured with a VIP directive for each PVE directive; 

the poll address in each pair of directives must be the same. 


*A single communications line can have up to 32 polled VIP sta- 
tions. The total of 32 may be achieved by any combination of 
actual VIP stations or emulated stations. At your option, up to 
32 stations may be combined in groups of 8 whem emulating a 
VIP 7760 line. All stations in a group must specify the same 


controlier poll address, as if they were connected to one VIP 
7760 controller. 


SIf the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be "paired" with 


the PVE directive (see “DEVICE Directive," earlier in this 
section). 


4A station can consist of up to 3 addressable components (screen/ 
keyboard, ROP, and/or cassette). 
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level 


The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
Station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci- 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. The level of all PVE 
stations on a common MLCP/DLCP channel must be the 

same. 


X'channel' 


A four-digit hexadecimal number (from X'040n' to 
X'FF8n'), specifying the channel number of the station 
and the interrupt priority level (n) of the line. The 
channel number has the following format: 


Bits 0 through 9 - The 10-bit channel address of the send 
or receive channel on the line. 


Bits 10 through 13 - Must be set to Zero. 


Bits 14 and 15 - Specifies n, the priority level at which 
a communications line interrupts the 
central processor. mn may have a value 
of 0,1,2, or 3 aS specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


[modem] 


A number specifying the type of data set. Possible 
values are as follows: 


O - Direct connect. 
2 - Bell 2xx-type modem (201A, 208B, etc.). The data- 
set-ready signal is needed for a connection; absence 


of this signal is a disconnection. 


3 or greater - User-defined modem (see “MODEM Directive" 
earlier in this section). 


The default iS modem type 2. 
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poll address 


Specifies the poll address of this station on the line 
identified by the channel argument. The poll address 
argument is an integer from 0 through 31. Each station 
on the line must have a unique poll address. 


[poll response] 


Specifies the type of response that PVE will generate if 
a select and/or poll is received for a station that is 
not logically connected. The possible values are: 


OA - If a non-connected station iS selected to 
receive data, PVE will respond to the subsequent 
poll with a positive acknowledgement (ACK). 


If a non-connected station is simply polled, PVE 
will respond with a quiescent (Q) frame. 


ON - I£ a non-connected station is selected to 
receive data, PVE will respond to the subsequent 
poll with a negative acknowledgement (NAK). 


If a non-connected station is simply polled, PVE 
will respond with a quiescent (Q) frame. 


Default: No response to poll. 
[controller poll address] (VIP 7760 only) 
The controller poll address associated with this station 
on the line; it equals the poll address of the VIP 7760 
controller to which this station iS connected. This sta- 
tion emulates a VIP 7760 station having the same control- 
ler poll address. controller poll address must be an 
integer ranging from 0 through 7. Several stations on 
the line may have the same controller poll address. 


Default: No controller poll address is assigned for this 
Station. 


Example: 

PVE 30,9,X'FD80',,0 

PVE 31,9,X'FD80',,1 

PVE 32,9,X'FD80',,2 
In this example, three polled VIP emulated stations are 
defined for a communications line (FD80). Each station has a 


unique lrn and poll address. The default value (2) is estab- 
lished for modem type. 
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The system at the other end of the communications line must 
be configured with VIP directives for the same physical 
line; each poll address in a PVE directive (in system "A") 


must be matched by a poll address in a VIP directive (in 
system "B"). 
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RCI DIRECTIVE 
Directive Name: RC I 


The RCI directive identifies a station on a line serviced by 
the Remote Computer Interface (RCI) line protocol handler.! 


Format: 


RCI lrn,level,X'channel',[{modem] 
Argument Description: 


lrn 


The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


level 


The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
Station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but is must be a higher 
number than the communications interrupt level(s) speci- 
fied in the COMM directive. the level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 


1If the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be "paired" with 
the RCI directive (see "DEVICE Directive", earlier in this sec- 
tion). If input/output to the station is to be asynchronous, 


the B (buffered) argument must be included in the DEVICE 
directive. 
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A four-digit hexadecimal number (from X'040n' to X'FF8n'") 
specifying the channel number of the station and the 
interrupt priority level (n) of the line. The channel 
number has the following format: 


Bits 0 through 9 - The 10-bit channel address of the send 
or receive channel on the line. 


Bits 10 through 13 - Must be set to Zero. 


Bits 14 and 15 - Specifies n, the priority level at which 
a communications line interrupts the 
central processor. mn may have a value 
of 0,1,2, or 3 aS Specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


[modem] 


A number specifying the type of data Set. Possible 
values are as follows: 


O - Direct connect. 
2 - Bell 2xx-type modem (201A,208B, etc.). the data- 
set-ready signal is needed for a connection; absence 


of this signal is a disconnection. 


3 or greater - User-defined modem type (see "MODEM Direc- 
tive", earlier in this Section). 


The default value iS modem type 2. 
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ROP DIRECTIVE 


Directive Name: ROP 


The ROP directive specifies that a receive-only printer (ROP) 
is connected to a Station on a line serviced by the STD line 
protocol handler. (See the STDLN directive for information 
on how to specify ROP directives in a CLM file.) 


Format: 
ROP rop_type 
Argument Description: 
rop_type 
Specifies the type of receive-only printer device that is 
connected to the station. Possible values for this argu- 


ment are: 


corresponding 
rop type device type 


1003 PRU1003 
1005 PRU1005 
TN 300 TermiNet 300 
TN 1200 TermiNet 1200 


One value for rop_type must be specified. 
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STAPOL DIRECTIVE 


Directive Wame: STAPOL 


The STAPOL directive defines the order in which stations are 
polled on a line serviced by the STD line protocol handler. 
The order in which stations are polled is determined by the 
position of arguments in the STAPOL directive. (See the 
STDLN directive for examples.) 


Format: 


STAPOL station _poll address [,station poll address, ] 
weeeeeee[,Station poll address, ] 


Argument Description: 
station poll address, 


Specifies the poll address of a station:on this line. 

Up to 15 station poll addresses may be specified. The 
station poll addresses must have been previously speci- 
fied in the STD directive associated with this line. The 
value of this argument must be in the range 0 through 3l. 
It may be specified as many times as is necessary to cre- 
ate the polling priority list for the line. 
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STATION DIRECTIVE 
Directive Name: STATION 


The STATION directive identifies the second or subsequent 
Station(s) on a line controlled by a user-written line proto- 
col handler that drives multiple stations per line. One sta- 
tion on the line must be identified by an LPHn directive; 
additional stations are identified by STATION directives, one 
per station, immediately following the related LPHn direc- 
tive. (See the LPHn directive for an example.) STATION 
directives and LPHn directives must immediately follow the 
LPHDEF directive that defines them in a CLM file. 


Format: 
STATION lIrn[{,lph_ specific word] 
Argument Description: 


lrn 


The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


[lph_specific_word] 


Specifies a word containing user-defined information that 
is to be passed to the line protocol handler through the 
station table, at offset ZOSSTS. The default is 0. 


NOTE: The priority level, channel number, modem type, line 
Speed, and line procedure (FDX/HDX) of stations 
described in STATION directives are obtained from the 
LPHn directive that precedes the STATION directive 


(see "LPHn Directive", earlier in this section). 


1For additional (polled) VIP's on a line, use additional VIP 
directives with the same level and channel number, rather than 
STATION directives. 
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STD DIRECTIVE! 
Directive Name: STD 


The STD directive identifies a station on a line serviced 
by the synchronous terminal device (STD) line protocol han- 
dler. See the STDLN directive for examples. 


Format: 


STD lrn,station_poll address[,,device type] 
Argument Description: 


lrn 


The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


Station_poll address 


Specifies the poll address of this station. MThe poll 
address is an integer from 0 through 31. Each station 
on the line must have a unique station poll address. 


[device type] 


Specifies the type of VIP terminal used. Possible values 
for device type are: 


1The STD directive and the VIP directive support synchronous 


terminals. The line protocol handler called by the STD direc- 
tive offers additional support capabilities (e.g., support of 
VIP7804 and VIP7805 terminals) not offered by the line protocol 
handler called by the VIP directive. 


6-59 CB23-03 


STD 


device type corresponding 


terminal type a 
V7804 VIP 7804/VIP 7805 aed 
V7700 VIP 7700/VIP 7700R/VIP 7705R 
V7760 VIP 7760 


If this argument is not specified, the default device type 
is V7700. 


When using the Synchronous Terminal Driver (STD) line preto- 
col handler, you must observe the following: 


The master LRN station must be the last station to be 
disconnected. 


The 7804 Control Byte Head of Form support translates to a 
7804 clear escape sequence. This sequence, in addition to 
positioning the cursor to the Home row, puts the 7804 in 
text mode. 


To use the STD LPH, the VIP 7804 hardware switches must be 
configured as follows: 


Reset, Text Mode, Verify before process, 
Transmit next block. 
Optional settings are: 

Roll/No Roll 

Space/No Space 

Return = Transmit/Normal 

Set Block Size 


VIP 7804 terminals are not compatible with VIP7700 termi- 
nals in the handling of end-of-message CR's and LF's. It 
is recommended that the new STD line protocol handler be 
used for VIP7804 support. If the VIP line protocol hand- 
ler is used to support a VIP7804 terminal, the following 
must be observed: 


1. RETURN=NORMAL must be selected at the terminal. 

2. The XMT key should be used to enter commands. 

3. When using the Editor, Linker, or other utility direc- 
tives with the prompt option, the RETURN key should be 
depressed before the SMT key. This will assure that 


the prompt appears on the next line rather than at the 
end of the current line. 
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STDLN DIRECTIVE 


Directive Name: STDLN 


The STDLN directive identifies a line serviced by the STD 
line protocol handler. (The STDLN directive does not support 
floating channel number assignments. You must explicitly 
specify the channel number argument.) 


Format: 


STDLN level,X'channel' ,[(modem] , [speed] [,2/4 wire] 
Argument Description: 


level 


The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value of the level is an integer from 8 
through 58; it may be the same as the level specified 

for other communications stations, but it must be a 
higher number than the communications interrupt level(s) 
Specified in the COMM directive. The level specified for 
one or more communications Stations may not also be used 
for non-communications devices or tasks. 


X'channel' 


A four-digit hexadecimal number (from X'040n' to 
X'FF8n'), Specifying the channel number of the station 
and the interrupt priority level (n) of the line. The 
channel number has the following format: 


Bits 0 through 9 - The 10-bit channel address of the send 
or receive channel on the line. 


Bits 10 through 13 - Must be set to zero. 


Bits 14 through 15 - Specifies n, the priority level at 
which a communications line inter- 
rupts the central processor. nm may 
have a value of 0,1,2, or 3 as 
Specified in the COMM directive. 
See the description of the COMM 
directive for further information. 
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STDLN 


[modem] 
e e : a PAs 
A number specifying the type of data set. Possible ‘ 
values are as follows: ee 


O —- Direct connect. 


2 - Bell 2xx-type modem (201A, 208B, etc.). The data- 
set-ready signal is needed for a connection; absence 
of this signal is a disconnection. 


3 or greater - User-defined modem (see "MODEM Directive," 
in this section). 


The default is modem type 2. 


[speed] 


The data rate in bits per second. The default value is 
2000. Other possible values for speed include: 


2400 
4800 
9600 
19200 


[2/4 wire] 
Specifies a 2 or 4 wire connection. Possible values are: 


value Meaning 


(default) W2 2-wire connection 


W4 4-wire connection 


Functional Description: 


The STDLN directive defines a line serviced by the STD 
line protocol handler; it precedes all other directives 
which characterize this line. Configuring a line ser- 
viced by the STD line protocol handler requires that at 
least four different directives be specified for the line 
and all stations on the line. These directives must be 


specified according toe the following guidelines: 


Required directives 


STDLN (specify one for each line) 

STD (Specify one for each station on the line) 
POLIST (specify one for each line) 

STAPOL (Specify one or more as needed) 
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Optional directive 
ROP 


sequence rules 


The following diagram illustrates the sequence rules that 
apply when specifying STDLN and other STD directives. One 
set of these directives must be specified for each line. 
Note that all directives which characterize the line must 
immediately follow the STDLN directive that identifies the 
line. Brackets enclose optional directives. 


STDLN must specify one for each line 
STD, 
Specify one set for each 
[ROP] specify one for each Station on the line; all must 
station, if needed precede POLIST 
STD, 
[ROP ] 
POLIST Must specify one for each line 
STAPOL must specify one or more 


for each line; all STAPOL 
directives should be specified 
in the order in which stations 
are to be polled 


Example 1: 


STDLN 20,X'FCOO',,2400,W4 
STD 20,1,,V7804 

ROP TN300 

STD 21,2,,V7804 

ROP ROSY26 

STD 22,3,,V7804 

POLIST 5 

STAPOL 1,2,1,3 


In this example, an STD line has been configured with three 
stations. As specified in the STDLN directive, this line's 
request level is 20, the channel number is FCOO, the default 
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NIGLS 


STDLN 


it 


modem used is type 2, the line speed is 2400 bits per second, 
and the line connection is 4-wire. All three stations sup- 
port VIP7804 terminals. The first station has an I1rn of 20, 
a poll address of 1, and includes a TN300 ROP. The second 
station has an Irn of 21, a poll address of 2 and includes a 
PRU 1005 ROP. The third station has an Irn of 22, a poll 
address of 3 and no ROP. The POLIST directive identifies the 
Start of the poll list and specifies a 5-second delay between 
successive poll list scans. This STAPOL directive specifies 
that the station with poll address 1 (lrn 20) is polled twice 
as often as the other two stations, implying that this statio 
has higher priority. 


Example 2: 


SYS @#eeeeee ee 


STDLN 10,X'FFOO',2,2400,W4 

STD 20,0,V7805 

ROP ROSY 26 

STD 21,1,V7804 

STD 22,2 

POLIST 2 

STAPOL 0,1,0,2 

DEVICE STD00,20,10,X'FF00',V7805,80,B 
DEVICE STD02,21,10,X'FFO00' ,V7804,80,B 
DEVICE STD03,22,10,X'FFO0' ,V7700,80,B 


The above example describes an STD line connected to the 
System through address "FFO0", with an interrupt level cof 10. 
The line uses a type "2" modem at 2400 baud and is a 4-wire 
connection. There are three VIP's on the line. The termi- 
nals will be polled in the following sequence for data: 
0,1,0,2; after which there will be a delay of two seconds 
before they are polled for data again. Address "0" will be 
polled twice as frequently as the other two terminals. All 
of the devices are configured for the file system, as shown 
in the DEVICE directives. (The DEVICE directives may appear 


aANnerhawan 


anywhere in your CLM file.) 
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STTY DIRECTIVE 


Directive Name: STTY 


The STTY directive specifies the file characteristics of a 
device that is not a disk device or a private device. The 
characteristics specified by this directive override the 

default characteristics established by the associated DEVICE 
directive (or the characteristics established by a previous 

STTY directive). The STTY command keyword format (as 

described in Appendix D) may be used as an alternative to the 
STTY directive format in your CLM file.! 


Format: 


device unit 
STTY device name, 


[length] ,[D'dsw,dsw, '],[{detab],[in], 
[out] [,type] 


Argument Description: 


device unit 
device name 


This entry, which identifies the device, must be the 

same aS one entered in a previous DEVICE directive. If 
device name was specified in a previous DEVICE directive, 
it must be entered here; i.e., the entry of device unit 
will result in error. The device _ unit and device name 
arguments each consists of a string of ASCII characters 
as described under the DEVICE directive. If there is no 
previous DEVICE directive having the string specified 
here, an error message is generated. 


[length] 


An integer giving the line length (record size) in bytes. 


'You must use the STTY command format in your CLM directive file 
if you wish to configure a device that can be automatically 
reconnected if a power resumption or line drop condition occurs. 
See Appendix D for information on how to configure devices as 
a reconnectable. The STTY command format is described in 
( Appendix D. 
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[D'dsw,dsw, '] 


Specifies the terminal's device specific words for \ 
connect/disconnect (dsw,) and read/write (dSwz). The 

values of dsw, and dsw>y are expressed in double-word for- 
mat aS a pair of 4-character hexadecimal numbers enclosed 

in apostrophes. 


__ STTY 


dsw, specifies certain characteristics of a device at 
open (connect) or close (disconnect) time, as shown in 
Tables 6-4 and 6-6. Refer to these tables when defining 
the 16-bit settings for dsw, that characterize connect/ 
disconnect functions. 


dsw. specifies certain characteristics of a device when 
reading or writing to a file, as shown in Tables 6-5 ana 
6-6. Refer to these tables when defining the 16-bit set- 
tings for dsw, that characterize read/write functions. 


If dsw, and dsw2 are not specified, certain default val- 
ues are assumed. Default values are listed in Table 6-7. 


Appendix D) may replace the STTY directive format 
in your CLM file. When used at CLM time, either 
STTY format will cause the initial dsw; and dswo 
assignments (as well as the current device speci- 
fic word assignments) to be modified. However, if 
the STTY command is specified at any time after 
system initialization, only the current device 
specific word assignments will be modified. Only 
at system building (CLM) time will the STTY direc- 
tive format or the STTY command keyword format 
modify both the current and the initial device 
Specific word assignments.! 


NOTE: The STTY command keyword format (as described in 


[detab] 


An alphabetic string that controls tabulation 


-ON Tab characters in the input stream are deleted and 
replaced by the number of spaces required to bring 
the cursor (or printer) to the next tab position. 
Tab positions are set by the MOD 400 system in 
increments of 10 (to print positions 11, 21, 31,...) 
and cannot be changed by the user. 


-OFF Tab characters in the input stream are not replaced 
by spaces. 


1In a diskette-based system, using the STTY command format in 
your CLM file results in the loader error 1609. If you wish to 
use the STTY command format in your CLM file, you must create a ian 
directory under the system root named SYSLIB2 and load in it the 
bound unit SSTY. 
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[in] 


An alphabetic character specifying the type of input 
accepted by the device. 


ALLS 


A - The device is to receive asynchronous input 
S - The device is to receive synchronous input 


N - The device is to receive nonbuffered synchronous 
input 


[out] 


An alphabetic character apecrrying the type of data 
transmitted by the device 


A - The device transmits asynchronous output 
S - The device transmits synchronous output 


N - The device transmits nonbuffered synchronous 
output 


[type] 
An alphabetic character specifying the device type 
I - The device is an input device 
O - The device is an output device 


B - The device is bidirectional; it receives and 
transmits 


Messages 


Error messages that may be issued during execution of this 
directive are as follows: 


133E CMD (STTY) ERROR. No previous DEVICE directive. 
133F CMD (STTY) ERROR. Invalid detab argument. 

1341 CMD (STTY) ERROR. Invalid in or out argument. 
1342 CMD (STTY) ERROR. Invalid type argument. 


Device Specific Words for Communications Devices 


Table 6-4 lists the bit settings for dsw, , the device 
Specific word for connect/disconnect functions. Table 6-5 lists 
the bit settings for dsw2 , the device specific word for read/ 
write functions. Use these tables in conjunction with Table 6-6 
to determine the definitions of each bit. : 
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> If you do not wish to specify dsw, and/or dsw2 in the STTY 

fe directive, the system assumes certain default values for them. a 
JF Refer to Table 6-7 for a list of device specific word defaults. | 
Y) 


Table 6-4. Values for dsw; 


LPH Q0123 45678 9 10 11 12 13 14 15 


A 
A 
A 
A 
A 
A 


Table 6-5. Values for dsw, 


LPH O12 3 45 678 9 10 11 12 13 14 15 
READ 


© BQmooco 


LPH 


Oo © 


O”moO 0” 


0 
0 
0 
0 
0 
0 


xyoor 
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Table 6-6. 


BIT If bit = 0: 


Dequeue remaining IORB's 
for channel 


Block mode not supported 


Buffer mode is single-block 


ETX mode (ATD Block mode 
only) 


Send CR after text of mess- 
age (Not supported for 
Supervisory message reads 
by ATD) 


No space suppress 
(VIP 7801) 


No Auto-dial used 


d Roll (VIP 7801) 
Don't echo input characters 


No time-out for read 


Don't save in read IORB 


function codes received in 
text header 


Don't abort read IORB 
requests (ATD) 


Use BSC2780 protocol 


Don't abort read/write 
requests 


Hang up the phone on dis- 
connect 


Don't abort write IORB 
requests (ATD) 


Control word present for 
read/write | 


Ov’ 


Bit Definitions 


If bit = l: 


Don't dequeue remaining IORB's 


for channel 


ATD Block mode supported 


Buffer mode is double-block. 
(Note: Double-block is not sup- 
ported by file manager) 


ETB/ETX specified on write 
Block mode) 


(ATD 


Don't send CR after text of 
message 


Space suppress (VIP 7801) 
applicable in block mode) 


(Only 


Use Auto-dial handler to dial 
connection 


No roll (VIP 7801) 
Echo input characters 
Time-out for read (immediate) 


Save up to 2 function codes 
received in text header 


Abort read IORB requests (ATD) 


Use 3780 protocol 

Abort read/write requests 

Don't hang up the phone on dis- 
connect (ATD Block mode) 


Abort write IORB requests (ATD) 


No control word for read/write 
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Table 6-6 


BIT If bit = 0: 


i 


Don't support preemptive 
write 


Don't set VIP 7804 CRT 
space suppress 


send a block ended by ETX 
set VIP 7804 CRT roll mode 
Don't send LF after text of 
message (Not supported for 
supervisory message reads 


by ATD) 


Data mode 1S non- 
transparent 


Don't set VIP 7804 CRT to 
block mode (RECV) 


set transparent printer 
mode 


Not reserved for cross- 
compatibility with STD lph 
Quit on receiving break 
(Not Supported for sSuper- 
visory message writes by 
ATD) 


Buffer mode is not multi- 
block 


Don't send EOT characters 
Don't support DLE EOT 

send ITB and &TB characters 
Include control byte 


Don't send DLE EOT for 
VIP 7804 
No echoplex (VIP 7801) 


Don't send RVI characters 


(cont). 


Bit Definitions 
If bit = l: 


Support preemptive write (ATD 
Block mode only) 


set VIP 7804 CRT space suppress 


send a block ended by ETB 
Don't set VIP 7804 CRT roll mode | 


send LF after text of message 


Data mode is transparent 


Set VIP 7804 CRT to block mode 
(RECV) 


Set non-transparent printer mode 


Reserved for cross-compatibility 
with STD lph 


Don't quit on receiving break 


Buffer mode is multi-block 


Send EOT characters 
support DLE EOT 


Send ETX characters 


Do not include control byte 


send DLE EOT for VIP 7804 


Echoplex (VIP 7801) ¢ 


Send RVI characters 7 —_ 
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Table 6-6 (cont). Bit Definitions 
BIT If bit : | If bit 


v Include received DEL Strip received DEL characters 
characters in buffer 


Home curSor on page over- Don't home cursor on page 
flow overflow 


Include control byte as No control byte (first byte is 
first byte data) 


Include ATTENTION character] Exclude ATTENTION character 


Return key equal transmit No specific meaning to return key 
key 


Transfer mode is character Transfer mode is page 


7804/5 Printer copy 
1 copy 010 3 copies 5 copies 110 


2 copies Oll 4 copies 6 copies 111 


P Logical Poll interval 


000 O sec 010 4 sec 110 
O01 1 sec Oll 5 sec lll 


R Logical read time-out interval (poll duration): 
= 10 min O01 = no time-out O min 11 = reserved for 
future use 
w,X LPH response to application when LPH receives data but no 


real IORB available. VIP status codes: 


00 = Send NAK 10 Return busy status 


01 Send ACK ll Send NAK (Same as OQ) 


0 indicates that you cannot use the bit. 


This table is organized by function for convenience only; 
there is no overlapping of bits. dsw, sets all bits for 
connect/disconnect functions. dsw, sets all bits for 
read/write functions. 
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Device 


System Defaults for dsw, and dsw, 
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TTY DIRECTIVE! 


Directive Name: TTY 


The TTY directive identifies a station on a line serviced by 
the TTY (teleprinter) line protocol handler. The TTY direc- 
tive supports asynchronous terminal devices as teleprinter- 
compatible devices. You may float the channel assignment in 
this directive, if you wish. 


Format: 
TTY Ilrn,level,X'channel',[modem],{speed|][,'device-type' ] 
Argument Description: 
Irn 
The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A ; 


program may use this number to identify the station when 
it requests an input/output operation to the station. 


1The TTY directive and the ATD directive support asynchronous 


terminal devices. The line protocol handler called by the TTY 
directive supports the physical terminal only in teleprinter 
mode. The TTY line protocol handler does not provide block mode 
support of VIP7800 devices; neither does it provide support for 
VIP7200 devices and VIP7800 devices in forms processing mode. 
(For these functions the ATD directive is required.) The ATD 
line protocol handler does not provide the transparent read I/O 
or Single character mode functions of the TTY line protocol 
handler. The number of words of resident memory required by the 
TTY line protocol handler is less than the number of words of 
resident memory required by the ATD line protocol handler. See 


the MOD 400 Executive Software Release Bulletin for comparative 
figures, 
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level 


The priority level at which the communications supervisor 


processes requests for an input/output operation to the Sa 


Station. The value of level is an integer from 7 through 
61; it may be the same as the level specified for other 
communications stations, but it must be a higher number 
than the communications interrupt level(s) specified in 
the COMM directive. The level specified for one or more 
communications stations may not also be used for non- 
communications devices or tasks. 


X'channel' 


You may specify a single zero(0) to float the channel 
number assignment or a four-digit hexadecimal number 

(from X'040n' to X'FF8n'), that specifies the channel 
number of the station and the interrupt priority level 


(n) of the line. The channel number has the following 
format: 


Bit 0 through 9 - The 10-bit channel address of the send 
or receive channel on the line. 


Bits 10 through 13 - Must be set to zero. 


Bits 14 and 15 - Specifies n, the priority level at which 
a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


[modem] 


A number specifying the type of data set. Possible 
values are as follows: 


O - Direct connect. 


1 - Bell lxx-type modem (103A, etc.). Both data-set- 
| ready and carrier-detect signals are required for a 


connection; absence of these signals is a 
disconnection. 


3 or greater - User-defined modem type (see "MODEM Direc- 
tive," earlier in this section). 


The default value is modem type l. 


ae, 
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[speed] 


The data rate in bits per second. 


For an asynchronous line with a communications-pac whose 
id is 2108, , use one of the following values for speed: 


50 300 2400 
vas 600 3600 
(default) 110 900 4800 


134 1200 7200 
150 1800 9600 


For an asynchronous line with a communications-pac whose 


id is 2100,, , 2110, , or 2118, , use one of the following 
values for speed: 


50 200 1800 
75 300 2000 
(default) 110 600 2400 


134 1050 4800 
150 1200 9600 


NOTE: If the data rate is 134.5, specify 134. 


You have the option to defer selection of the line speed 
until the terminal comes online. You select this option 
by specifying HI or LO. 


AT. 


Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 1200 through 9600 bits per second. 


‘TO! 


Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 110 through 1200 bits per second. 


For more information about the line speed selection capa- 
bility, refer to the discussion under "Topics Related to 
CLM Directives" near the beginning of this section. 


['device-type' ] 


Specifies the type of terminal used. If this argument is 
not specified, the default is TTY. Possible values are: 
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ALL 


TTY 


Value Physical devices supported 


7200 VIP 7200, VIP 7205 

7801 VIP 7801, VIP 7802 

PRU PRU 1001, PRU 1003, PRU 1005, 
TWU 1001, TWU 1003, TWU 1005 

TTY An asynchronous terminal that 


is to be suported as teleprinter- 
compatible 


Example 1: 


TTY 21,8,X'FF80' 


DEVICE TTY01,21,8,X'FF80',TTY1 


In this example, the TTY is connected by a Bell 1xx-type 
modem and operates at 110 bits per second. Default values 
for modem type and line speed have been used. The TTY is to 
be accessible through the file system interface (by virtue of 


the DEVICE directive). 


Example 2: 


TTY 22,8,X'FFOO',0,1200 


DEVICE TTY02,22,8,X'FFOO',TTY2 


In this example, the TTY is connected by a direct cable con- 
nection and operates at 1200 bitsS per second. These charac- 
teristics are reflected by explicit arguments in the TTY 
directive. Again, the TTY iS to be accessible through the 


file system interface. 
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VDAM DIRECTIVE 
Directive Name: VDAM 
The VDAM directive must be specified if the Display Formatt- 
ing and Control software is to be used. This directive 
causes the software component to be incorporated in the 
configuration.’ You must configure the Display Formatting and 
Control Software if your installation will support DEF-II or 
DEF-II and TCLF. See Appendix P for further information on 
configuring the Display Formatting and Control Software. 


Format: 
VDAM [lrn,level] [,maximum terminals] 
Argument Description: 


lrn 


The logical resource number associated with the VDAM 
task. The value for lrn is an integer from 3 through 
255. This value must be specified if asynchronous VDAM 
processing is desired. The next two sequential Irns will 
be reserved for VDAM processing. 


level 
The value for level must be an integer from 7 through 61. 


This value must be specified if asynchronous VDAM proces- 
Sing 1S desired. 


The priority level at which VDAM processing operates. 


NOTE: Both Irn and level must be specified, or neither 
argument should be specified. If neither one is 
specified, the default is that no asynchronous 
instructions are issued to VDAM. 


1 Display processing requires VIP 7200/7205 or VIP 7801/7802 
. terminals. The terminals can be configured using an ATD or a 
| V7200 directive. 
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[maximum terminals] 


The maximum number of terminals that use VDAM processing 
in one task group. If a number iS not specified, the 
default value is 10. 
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VIP DIRECTIVE 
Directive Name: VIP 


The VIP directive identifies a polled or nonpolled visual 
information projection station on a line serviced by the 

VIP line protocol handler. Optionally, the VIP directive 
identifies a ROP (receive-only printer) station on the same 
line .1.2,3.4 VIP 7700, VIP 7700R/7705R, VIP 7804/7805 (in 
VIP7700 mode) and VIP 7760 terminals are Supported. You may 
float channel assignments in this directive, if you wish. 


Format: 


C 
VIP Irn,level,X'channel',[{modem|,[poll address], 4s) 
[ROP lrn],{ROP type] [,ROP form feed] 


'The VIP directive and the STD directive both support synchronous 
terminals. The line protocol handler called by the STD direc- 
tive offers additional support capabilities (e.g., support of 
VIP7804 and VIP7805 terminals) not offered by the line protocol 
handler called by the VIP directive. 


2If the Configuration Load Manager detects an error in a VIP 


directive, the error must be corrected in the CLM USER file and 
the system bootstrapped again. 


3If the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be "paired" with 


the VIP directive (see "DEVICE Directive," earlier in this 
section). 


4TIf a "remote" system is to perform polled VIP emulation, see 
"PVE Directive," earlier in this section, for a description of 
the relationship between VIP directives for the "local" system 
and PVE directives for the "remote" system. 
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Argument Description: 


lyn 


The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


level 


The priority level at which the communications SuperviSor 
processes requests for an input/output operation to the 
Station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 


number than the communications interrupt level(s) speci- 


fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 


The level for all polled VIP'sS on a common MLCP channel 
must be the same. 


X'channel 


You may specify a single zero (0) to float this channel 
assignment or a four-digit hexadecimal number (from 

X'040n' to X'FF8n'), that specifies the channel number 
of the station and the interrupt priority level (n) of 
the line. The channel number has the following format: 


Bits 0 through 9 - The 10-bit channel address of the 
send or receive channel on the line. 


Bits 10 through 13 - Must be set to zero. 


Bits 14 oud. 15 - Specifies n, the priority level at which 
a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 aS Specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


[modem | 


A number specifying the type of data set. Possible 
values are as follows: 


O - Direct connect. 
2 - Bell 2xx-type modem (201A, 208B, etc.). The data- 


set-ready signal is needed for a connection; absence 
of this signal is a disconnection. 
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3 or greater - User-defined modem type (see "MODEM Direc- 
tive," earlier in this section). 


The default value iS modem type 2. 
[poll address] 


Specifies the address of the VIP station on the line 
specified by the channel argument. The value for poll _ 
address iS an integer from 0 through 31. If no polling 
address is specified, no polling can occur on the line; 
in this case, only one VIP station can be on the line. 


This argument is meaningful in only two situations: 

(1) a file-transmission (nonpolled) environment and 

(2) a nonpolled environment wherein the VIP is to be 
accessible through the file system interface. (In the 
second situation, the VIP directive must be "paired" with 
an appropriate DEVICE directive.) 


C specifies that the central processor is the control 
Station; T specifies that the central processor is the 
tributary station. The tributary station must send the 
first Q (quiescent) frame on the line. The default value 
PS. (Cy 


(In the nonpolled, file system accesSs environment, 
T should be specified in the VIP directive in order to 
avoid excessive delays in input/output operations.) 


[ROP Irn] 


Specifies the logical resource number of a receive-only 
printer connected to the VIP controller. The value for 
ROP Irn is an integer from 3 through 252. The default 
is that no receive-only printer is connected to the VIP 
controller; in this case, the ROP type and ROP form feed 
arguments must not be specified. ~ 7 _ 


[ROP type] 


Specifies the type of receive-only printer. Choose from 
one of the following: 


ROP type Corresponding 
device type 


TN300 (default) TermiNet 300 or PRU1003 


TN1200 TermiNet 1200 or PRU1O005 
TTY 33 ASR-33 
TIY35 ASR-35 
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[ROP form feed] 


Specifies whether the receive-only printer has a 
form-feed option. FORM or FO indicates that the 
receive only printer does have the form-feed option; 
NOFORM or NO indicates that it does not have the 
form-feed option. a 


The default is that TermiNets have the form-feed option 
and the TTY's do not have the form-feed option. 


NOTE: The following rulesS apply to lines that have more than 
one VIP station (i.e., a polled VIP environment): 
(1) a separate VIP directive is required for each 
Station on the line, (2) the VIP directives be con- 


secutive, and (3) the logical resource numbers of the 
Stations on the line must be consecutive. 


Examples: 


In the following examples, VIP stations are connected by Bell 
2xx-type modems. Default values for modem type have been 
used. DEVICE directives are "paired" with the VIP directives 
because the VIP's are to be accessible through the file 
System interface. 
Example 1: 

VIP 23,8,X'FE80',,0 

DEVICE VIPO00,23,8,X'FE80',VIPO 
In this example, the VIP has a poll address of 0. 


Example 2: 

VIP 24,8,X'FE80',,1,,25,TN1200 

DEVICE VIP0O1,24,8,X'FE80',VIPI1 

DEVICE ROPO1,25,8,X'FE80',ROP1 
In this example, the VIP has a poll address‘of 1. In addi-_ 
tion to the VIP screen, the VIP controller has a TermiNet 


1200 as a receive-only printer. The VIP screen's logical 


resource number is 24 and the receive-only printer's logical 
resource number is 25. 
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VROSY, VTTY, AND V7200 DIRECTIVES” 
Directive Name: VROSY, VTTY, or V7200 
These directives define devices that are on lines serviced 
by the ATD line protocol handler. Except for the directive 
name, the format iS the same for all three directives. You 


can float channel assignments in these directives. 

Format: 

VROS Y 

VTTY Irn, level ,X'channel',[modem],{[speed],f[device typel, 
V7200 : [del] ,({stop bit] [,parityl] 
Argument Description: 


lrn 


The value for lrn iS an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


The logical resource number associated with the station. [ 


1The ATD directive intended as a replacement for the VROSY, VTTY, * 
and V7200 directives. The line protocol handler called by the 

ATD directive offers additional support capabilities (e.g., 

block mode support of VIP7801/7802 devices, Support of the 

VIP7207 device) not offered by the line protocol handler called 

by the VROSY, VTTY, and V7200 directives. The VROSY, VTTY, and 
V/200 directives can still be used. The directives, however, 

call the ATD line protocol handler. 


2The ATD directive or the V7200 directive must be specified if 
VIP7200/7205 or VIP7801/7802 terminals are to be used for forms 
processing uSing Honeywell's Display Formatting and Control 
Facility. The VIP 7200 line protocol handler "nonforms mode" is 
not supported by ATD. The equivalent functions can be obtained 
on by using the forms mode with a form defined as fully 
( unprotected. 
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level 


The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci- 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 


X'channel' 


You may specify a single zero (0) to float this channel 
assignment or a four-digit hexadecimal number (from 

X'O40n' to X'FF8n'), that specifies the channel number 
of the station and the interrupt priority level (n) of 
the line. The channel number has the following format: 


VROSY/VTTY/V7200 


Bits 0 through 9 - The 10-bit channel address of the send 
or receive channel on the line. 


Bits 10 through 13 -—- Must be set to zero. 


Bits 14 and 15 - Specifies n, the priority level at which 
a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 aS specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


[modem] 


A number specifying the type of data set. Possible 
values are as follows: 


O - Direct connect. 
x 1 - Bell lxx-type modem (103A, etc.). Both data-set- 
ready and carrier-detect signals are required for a 
connection; absence of these signals is a 
disconnection. 


o* 3 or greater - User-defined modem type (see "MODEM 
tive," earlier in this section). 


The default value is modem type l. 
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[speed] 


The data rate in bitS per second. 


For an asynchronous line with a communications-pac whose 
id is 2108,, , use one of the following values for speed: 


50 300 2400 
75 600 3600 
(default) 110 900 4800 


134 1200 7200 
150 1800 9600 


For an asynchronous line with a communications-—pac whose 
id is 2100,,, 2110,,, or 2118,, use one of the following 
values for speed: 


50 200 1800 
75 300 2000 
(default) 110 600 2400 


134 1050 4800 
150 1200 9600 


In VTTY or V7200 directives, you have the option to defer 
selection of the line speed until the terminal comes on- 
line. You select this option by specifying HI or LO. 


"HI' 


Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 1200 through 9600 bits per second. 


“EO* 


Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 110 through 1200 bits per second. 


For more information about the line speed selection capa- 
bility, refer to the discussion under "Topics Related to 
CLM Directives" near the beginning of this section. 


[device type] 


Specifies the type of terminal used. The allowable types 
and the default for each directive are as follows: 
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VROSY/VTTY/V7200 


Directive 


Devices supported 


device type 


ao™~ 
V7200 VIP 7200, VIP 7205 7200 eal 
VIP 7801, VIP 7802 7801 
VROSY PRU 1001, PRU 1003, PRU 1005, PRU 
TWU 1001, TWU 1003, TWU 1005 
VTTY An asynchronous terminal that Try 
is to be supported as 
teleprinter-compatible 
(del] 
In the TTY mode, a head-of-form sequence (pre-order con- 
trol) consisting of three LF'sS and the number of DEL 
Characters specified by this argument is generated if the 
following conditions are met. (If the conditions are not 
met, no head-of-form sequence iS generated.) 

e The first byte of the application's buffer must be 
designated aS a control byte; i.e., bit 4 of the 
IORB's device specific word (I DVS) must be set 
to 0 at write time. 

e The control byte must specify that a head-of-form 
sequence is to be generated; i.e., bit 3 of the 3 
control byte must be set to l. 

e Device type PRU is not specified. If it is speci- 
fied, a true head-of-form is issued. 

In the field or TTY modes, an LF in an end-of-message 
Sequence (post order control) is followed by the number 
of DEL characters specified by this control argument. 
The EOM sequence is controlled by the B- and C-bits of 
the IORB's device specific word I DVS, as specified by 
the application at write time. The TTY line protocol 
handler sends an EOM Sequence according to the following 
B- and C-bit values. 
I DVS Bits 
B C EOM Sequence 
C 0 CR 
0 i None 
] 6) CR,LF,DEL characters 
1 1 LF,DEL characters 
«o™~ 
- 
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At read time, the application can specify the same B- and 
C- bit values in order to send an EOM sequence back to 
the terminal when the message is successfully received. 


Note that an LF character in a pre-order control speci- 

fied by the I CON word of an IORB is never followed by a 
DEL character; i.e., this control argument has no effect 
in this case. 


This argument allows you to select 1 to 32 DEL char- 
acters. The default for each type of device is as 


follows: 
device type Number of DEL Characters 
7200 0 
7801 0 
PRU 1 
TTY 1 
[stop bit] 


Specifies the number of stop bits that are to follow each 
character. A value of 1 or 2 can be chosen for each 
device. Default values are as follows: 
Number of Stop Bits 
l 
(For speeds greater 


than 110 bits per 
second) 


2 
(For a speed of 110 


bits per second or 
less) 


[parity] 


Specifies the type of parity (enter ODD or EVEN) to be 
used. The default is EVEN. 
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SECTION 7 


MOD 400 PROGRAM MATERIALS AND DISTRIBUTION MEDIA 


A listing of MOD 400 program materials is provided in 
Figures 7-1 through 7-19. Figure 7-1 lists the program materials 
made avallable with the MOD 400 Executive. Figures 7-2 through 
7-19 list the program materials made available with the various 
Separately-priced products that can be used with the MOD 400 
Executive. Order numbers for these products are also provided. 


MOD 400 software is available on the following media: 


e Cartridge Disk 

e Cartridge Module Disk 
e Mass Storage Unit 

e Diskettes 


MOD 400 Executive software can be distributed on two 
Cartridge disks (“ZSYS51 and “ZSYS52), a single cartridge module 
disk (“ZSYS61), or on a single mass storage unit (“*ZSYS71). If 
an installation orders any of the separately-priced products, 
appropriate modules are added to “ZSYS51 and “ZSYS52, “ZSYS6l1, or 
“ZSYS71, or they are provided on separate diskettes. 


MOD 400 Executive software is made available on up to five 
diskettes (“ZSYS00, ~“ZSYSOA, “ZSYS01, “ZSYS1A, “ZSYS1B). The 
Software will be packaged to make most effective use of the 
distribution media. Software will be packaged in up to five 
diskettes if the user receives the software on single-sided 
diskettes. If the user submits diskettes with a larger capacity, 
then fewer diskettes are required. 


Users performing system installation with Honeywell-supplied 
distribution media should note the following: 


e If the MOD 400 Executive was distributed on cartridge 
disks, a cartridge module disk, or a masSs storage unit, 
then all Executive modules will be present on the 
volume(s). 
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e If the MOD 400 Executive was distributed on multiple 
diskettes, then each diskette will contain a subset of the 
total number of Executive modules. The diskette labeled 
“ZSYSOO must be used as the bootstrap volume at initial 
system startup. The user must be aware, however, that 
“ZSYSOO will not contain sufficient software to permit use 
of the full range of MOD 400 functionality. Once the user 
attains the limited processing environment permitted with 
“ZSYS00, then the user should examine the contents of the 
other diskettes and delete and transfer software modules 
as desired. The user can consult Figure 7-1 to identify 
Executive modules required for various MOD 400 functions. 


In Figures 7-1 through 7-19, elements enclosed within boxes 
are file system directories. Other elements are files.! 
Indentation signifies subordination - that is, all files 
described in a given directory are indented from the margin of 
the boxed directory name. In a few instances, one directory is 
shown to be subordinate to another directory; again, indentation 
is used to signify this relationship. 


SOFTWARE TO BE PLACED ON THE BOOTSTRAP VOLUME 


Certain modules must be present on the bootstrap volume in 
order to achieve system startup. Other modules must be present 
on the bootstrap volume if certain types of proceSsing are to be 
Supported. These required modules are described in the following 
diagrams. 


+Note that in some cases files are immediately subordinate to the 
volume root directory. 
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Z3EXECUTIVES? 


Z3EXECUTIVEL?® 
START UP.EC 
GROUPS$H.EC 
GROUPSP.EC 


SUPER.EC 


GROUPSD.EC 


DEBUG .WORK 


DEBUGDB 


RECOVERY 


START UP.EC 


EML 


EXECUTIVE 


ZIMLCC.O 
ZGQISB.O 


Figure 7-1. 


SAF system executive; required 
LAF system executive; required 
File used with CLM USER; required 
EC file to Spawn SH task group 
EC file to spawn $P tasSk group 


EC file required for a dual-purpose operator 
terminal 


EC file to spawn $D task group 
Work file for $D DEBUG 
Lead task of $D DEBUG utility 


File recovery 

File used for $H task group; required if 
CLM MDC or CLM MCP used 

Error message library 


mailbox queue 
mailbox queue 


MOD 400 Executive Program Materials 
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MACRO 
INCLUDE 


CCP MAC.IN.A 
MGIRB.IN.C 
MGRRB.IN.C 
DLCP.IN.A 
MGCRB.IN.C 


START UP.EC File used with CLM MDC or CLM MCP; required 
only if either is present 


CLM SAMPLE Sample CLM file; optional 
CIPSIM Commercial simulator 

CLM Configuration Load Manager; required 
CLMCM]1 CLM functions; required 
CLMCM2 CLM functions; required 
CLMCM3 CLM functions; required 
CLMCM4 CLM functions; required 
CLMCOM CLM functions; required 
CLMDEV CLM functions; required 
CLMFLT CLM functions; required 
CLMMMU CLM functions; required 
CLMLHD CLM functions; required 
CLMMAP CLM functions; required 
CLMST1 CLM tables; required 
CLMST2 CLM tables; required 
CLMST3 CLM tables; required 


CLMVAR CLM functions; required 


RESOLA Makes all Executive overlays resident; 
optional’ 


Figure 7-1 (cont). MOD 400 Executive Program Materials 
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SID 


ROLLCD 


SIPSIM 


SIPSIM SP 


VLDCD 


ZERRST 
ZGQOCDS 
ZNV72F 
ZNVDAM 
ZQEACU 
ZQESEL 
ZQEXEC 


ZQHLPH 


ZQPATD 


ZQPCRT 


ZXPFR 
ZQOPTTY 
ZQPVIP 


ZORCI 


ZOTDUM 
ZQTRAX 
ZXDEFM 


ZQECPI 


(cont). 


CLM code for rollout function; required only 
if rollout capability is configured 


Single/Double Precision SIP Simulator‘ 
Single Precision SIP Simulator‘ 


CLM code for MMU functions; required only if 
MMU present 


Error statistics module; optional‘ 

CLM communications module“ 

Display Formatting and Control software* 
Display Formatting and Control software‘ 
Auto Call module; optional 

Speed select module; optional* 
Communications supervisor® 


Communications HASP line protocol handler; 
optional’ 


Communications asynchronous terminal line 
protocol handler; optional‘ 


Communications synchronous terminal line 
protocol handler; optional‘ 


Power Resumption Facility; optional 
Communications TTY line protocol handler°¢ 
Communications VIP line protocol handler®¢ 


Communications RCI line protocol handler; 
optional’ 


Required for a communications configuration® 
Internal Diagnostic Trace Capability‘ 
Defective Memory Trap Handler‘ 


Auto Call channel control program; optional‘ 
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SID] (cont). 


ZQPATC ATD channel control program; optional 

ZQPCCP STD channel control program; optional 

ZQPTCP TTY channel control program; optional‘ 

CLM MCP File of CLM directives used during stage l 

~~ : system startup with MLCP/DLCP-connected 

operator terminal; required if your installa- 
tion has an MLCP/DLCP-connected operator 
terminal. 

CLM MDC File of CLM directives used during stage l 


SYSLIB1 


system startup with MDC-connected operator 
terminal; required if your installation has 
an MDC-connected operator terminal. 


EC Execution command used for EC files; required 
if any START UP.EC file used 
CSD Change system directory operator command; 


SYSLIB2 


required 


SYSLIB2|] (cont). |SYSLIB2]| (cont). 


ABORT BATCH DP PR HOLD 
ABORT GROUP DPEDIT QUERY 

ABR DPN RDF 

ACTB DT: RDN? 

ACTG EBR RESTART 
AGR ECd SD 

AMM EGR SET ELOG 
AMT EQUAL SET LISTEN 
BYE ETR SG? 

CB FO SMM 

CG LISTENER SSPB 

CGRQ LOAD SSPG 

CMBX LOR ST 

CQR LSR START ELOG 
CT MAIL START MAIL 
CyD MSG STG 

DB MSWS STOP ELOG 
DEBUG NEW PROC STS 

DEL CUM NOW — TIME 

DG OPER UNLD ; 

DMNC PR ELOG UPD CUM 
DMON PR CUM USER 
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SYSLIB2 (cont). 


VFORMS 
ZELUPD 
ZNVCRM 
ZNVUPR 


CKMSV 


FORMS 


VDAM FORMO] 
RDYT 


*Present only on SAF medium 


SYSLIB2 (cont). 


IM PAM 


>Present only on LAF medium 


SYSLIB2 


(cont). 


LTC 
LWD? 

LX 

M4 SYSDEF4 
MFA 
PATCH 
PR 

PR QK 
ORPT 
RECOVER 
REMOVE 
RESTORE 
RL 

RN 

RQM 

SA 

SAVE 
SCA 

SDL 
STTY 
TPOS 
UNSP 
VALIDCKPT 
WH 


(cont). PROGS 


MT9GI 


MT7G1 TRANS 
ZT VM 
ZTVIOD 


“If the system is to include this capability, this system software 
must be present on the bootstrap volume before configuration. 


NOTE: Software modules listed as being optional may be judi- 
clouSly deleted if the user does not wish to configure a 


particular capability; 


otherwise, 


the appropriate software 


modules must be included with the Executive software if 
the user wishes to configure an optional capability. 


d¢Required for Stage 1 and Stage 2 system startup. 


Figure 7-1 (cont). 
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SYSLIB2 
ASSEM oo 
MACROP 

LDD 


OBJECT 


EXECUTIVE 


ZGQISB.O 
ZIMLCC.O 
| MACRO 
EXEC LIB 
macro routines 
XNP_USER 


macro routines 


Figure 7-2. Assembler/Macro Preprocessor 
Program Materials (SHL928) 
SYSLIB2 
FORTRAN 
ZERT 


object modules 


Figure 7-3. FORTRAN Program Materials (SHL921) 


SYSLIB2 


COBOL (entry level) 


ZCRT 


object modules 


Figure 7-4. Entry-Level COBOL Program Materials (SHL917) a 
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SYSLIB2 
( RPG 
AUTO 


AUTOR 


Figure 7-5. RPG Program Materials (SHL926) 


SYSLIB2 | 
SORT 
SORTC 


MERGE 


Figure 7-6. SORT/MERGE Program Materials (SHF909) 


SID 
ZQPBSC'! 
{ HLPH' 


SYSLIB2 


TRANB 


'These program materials must be transferred to the bootstrap 
volume before configuration. 


Figure 7-7. File Transmission (Non-Honeywell Host) 
(SHC909) 


1SYSLIB2 


COBOLI (intermediate level) 


object modules 


Figure 7-8. Intermediate COBOL Program Materials 
(SHL925) 
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ZDRT 


DEF SAMPLE.S _ -_ 
- ae, 
object modules 
Figure 7-9. DEF-I Program Materials (SHC917) 
SYSLIB2 
RBT 
Figure 7-10. RBF/66 Program Materials (SHC915) 
SID SYSLIB2 
ZOPPVE! TRAN 
Z QHLOG! 
ZQHP LM! 
RBRCIP'! 
i'These program materials must be transferred to the bootstrap «| 
volume before configuration. 
Figure 7-ll. File Transmission (Honeywell Host) 
Program Materials (SHC911) 
| SYSLIB2 
HAS P 
Figure 7-12. HASP Workstation Facility Program 
Materials (SHC926) 
| SYSLIB2 | 
WS 2780 
WS 3780 
Figure 7-13. 2780/3780 Workstation Facility oN 
Program Materials (SHC922) he j 
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SID 


ZQPPBS' 


SYSLIB2 
IF3271 
ZE32IN 


ZCOBIF.O 


'These program materials must be transferred to the bootstrap 
volume before configuration. 


Figure 7-14. Programmable Facility/3271 Program 
Materials (SHC924) 


SYSLIB2 


TCLC 
TCLP 


Figure 7-15. TCLF Program Materials (SHS920) 


SYSLIB2 


FORTRANA 


ZFIRT 


runtime routines 


Figure 7-16. Advanced FORTRAN Program Materials (SHL927) 
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BASIC 
RESEO 
LNKB PRG. EC 


runtime routines 


ZBRTS 


runtime routines 


Figure 7-17. BASIC Program Materials (SHL930) Interpreter, 
(SHL931) Interpreter/Compiler 


SYSLIB2 


DEF 


DEFMENU 


DEF-II system forms 


Figure 7-18. DEF-II Program Materials (SHC949Q9) 


SYSLIB2 


COBOLA 


ZCART 


object modules 


Figure 7-19. Advanced COBOL Program Materials (SHL933) 
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SECTION 8 


TECHNICAL NOTES 


This section describes a number of miscellaneous topics, most 
of which pertain only to certain installation sites. Before 
attempting any use of the system, you should ascertain which of 
these topics apply to your installation and proceed accordingly. 
The following topics are described: 


¢ * 
e CSD (change system directory) operator commands in 
START UP.EC file for system task group 
e Transferring the contents of “ZSYS51 or “ZSYS61 to the 
fixed platter of a two-platter drive 
e System search rules and the system commands 
@e Procedure for transferring software modules 
* 


CSD OPERATOR COMMANDS IN START_UP.EC FILE FOR SYSTEM TASK GROUP 


If a START UP.EC file is used for the system task group 
during a stage 3 system startup!, it must be immediately subordi- 
nate to the root directory of the bootstrap volume. This 
START UP.EC file should contain one or more CSD (change system 
directory) operator commands to reassign the system libraries 
-LIB1 and -LIB2 away from their defaults (the default assignment 
for both -LIBl1 and -LIB2 is SYSLIB1 on the bootstrap volume). 


If the system is to be bootstrapped from a non-diskette 
volume, the START UP.EC file for the system task group should 
contain the following two CSD operator commands (in addition to 
any other appropriate operator commands) : 

CSD ~LIB1 pathname to_user library 


CSD -LIB2 >SYSLIB2 


1The stages of system startup are described in Section 3. 
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These operator commands will appropriately specialize the sys- 


tem's search rules for this environment. When the system's aS 


a 
= 


loader seeks a bound unit to be loaded, it will first search the 
user's working directory (default), then (if necessary) the user_ 
library (-LIB1), then (if necessary) SYSLIB2 on the bootstrap 
volume (-LIB2). 


If the system is to be bootstrapped from diskette (“ZSYS00), 
the START _UP.EC file for the system task group should contain the 
following CSD operator command: 


CSD -LIB1 *ZSYS01>SYSLIB1 


This operator command will appropriately specialize the system's 
search rules for a diskette environment. When the system's 
loader seeks a bound unit to be loaded, it will first search the 
user's working directory (default), then (if necessary) 
“ZSYSO1>SYSLIB1 (-LIB1l). Typically, in a diskette environment, 
the operator uses dynamic CSD operator commands to assign -LIB2 
to the pathname that will be searched (if necessary) following 
“ZSYSO1>SYSLIBI. 


TRANSFERRING CONTENTS OF “ZSYS51 OR “ZSYS61 TO FIXED PLATTER 
6 


| If your system is cartridge-disk-based or cartridge-module- 
disk-based, you may wish to copy the contents of your system 
volume to the fixed platter of a two-platter drive. The original 
Honeywell-supplied system volume may then be dismounted and saved 
as backup. The following procedure is recommended : 


1. Mount system volume “ZSYS51 on RCDOO, or mount system 
volume “ZSYS61 on RCMOO. 


2. Perform a stage 2 system startup, bootstrapping the 
system from RCDOO or RCMOO. 


1ASSume that this action involves a stage 2 system startup; the 
CLM_USER file is assumed to include the following DEVICE 
directives: 
For cartridge disk-based systems: 
DEVICE RCDOO,1,6,X'1400' (removable cartridge disk) 
DEVICE FCDO00,3,6,X'1400' (fixed cartridge disk) 


For cartridge module disk-based systems: 


DEVICE RCMO0O,1,6,X'1400' (removable cartridge module disk) 


DEVICE FCM00,3,6,X'1400' (fixed cartridge module disk) WY 
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Use the following CV (create volume) command to initial- 
ize the fixed platter of the cartridge disk: 


CV !FCDOO -FT ZUSR51 


(ZUSR51 is merely an example of a user-Supplied volume _ 
id.) 


If your system iS cartridge module disk-based, use the 
following CV (create volume) command to initialize the 
fixed platter of the cartridge module disk: 

CV !FCMOO -FT ZUSR61 


(ZUSR61 iS merely an example of a user-Supplied volume 
id.) > 


Use the following CP (copy) command to copy the entire 
contents (except volume id) of “ZSYS51 to ~ZUSR51: 


CP !RCDOO>ZSYS51 !FCDOO -VOL 
If your system is cartridge module disk-based, use the 
following copy (CP) command to copy the entire contents 
(except volume id) of “ZSYS61 to “ZUSR61: 

CP !RCMOO>ZSYS61 !FCMO0OO -VOL 
After the copy is completed, press STOP. 
Perform another stage 2 system startup, this time boot- 
strapping the system from FCDOO or FCMOO, aS appropriate. 
(Enter 1401 into the Rl-register after the TRAFFIC light 


turns off following Stop, CLeaR, Load, Execute.) 


When system startup is complete, dismount “~ZSYS51 from 
RCDOO or “ZSYS61 from RCMOO. 


Mount a new cartridge disk on RCDOO or RCMOO, as 
appropriate. 


For cartridge disk-based systems, use the following CV 
command to initialize the new cartridge disk: 


CV !RCDOQ -FT USRVOL 
For cartridge module disk-based systems, use the follow- 
ing CV command to initialize the new cartridge module 
disk | 

CV !RCMOO -FT USRVOL 
(USRVOL is merely an example of a user-Supplied volume _ 


id.) | | 
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10. Use the following CV command to create a bootstrap record 
on “USRVOL: (The bootstrap record must be on the 
removable volume, even though the system is to be boot- 
Strapped from the fixed platter.) 


CV !RCDOO>USRVOL -BOOT [xX'1401"']' 


For cartridge module disk-based system, use the following 
command: 


CV !RCMOO>USRVOL -BOOT [xX'1401']!' 


NOTE: After a bootstrap record on a removable cartridge 
disk or cartridge module disk has been used to 
bootstrap the system executive from the fixed 
cartridge disk or cartridge module disk, the | 
volume id of the fixed cartridge disk or cartridge 
module disk is asSumed to be to the left of an 
absolute pathname that begins with a greater-than 
Sign (>). 


SYSTEM SEARCH RULES AND THE SYSTEM COMMANDS 


The system builder should insure that system commands (or at 
least that subset of Syetem commands most frequently used) are 
accesSible to the system's loader. 


When the system's loader seeks a bound unit to be loaded, it 
proceeds as follows: 


If the user supplies a full pathname (one beginning with a 
circumflex and the volume id), then the system loader will 
search for that specific element. 


If the user supplies a simple (single-element) pathname, then 
the system loader will search for the element according to a 
set of search rules. 


The search rules specify the order in which the loader is to 
search one or more directories for the element in the simple 
pathname. The default search rules for MOD 400 are (1) first 
search the user's working directory, (2) next search the system 
directory SYSLIB1 on the root volume and (3) finally search the 
system directory SYSLIB2 on the root volume. 


1I£ XTLT401I° Is not Specified, 1401 must be entered into the Rl- 
register (as Shown in step 6) whenever the system is boot- 
Strapped from the fixed platter; however, other bootstrap 
options (see Table 3-2) can be used more flexibly if the boot- 
Strap channel number (plus options) is entered into the Rl- 
register each time the system is bootstrapped. 
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The operator can use the CSD command to change the system 
search rules. In normal operations the operator should use the 
CSD command to specify that one of the directories to be searched 
is the system directory containing the system commands. The user 
should note that those system commands not accessible to the 
loader under the search rules must be specified with a full path- 
name. (For example, the CP command would require the user to 
specify “volume id>SYSLIB1D>CP.) 


PROCEDURE FOR TRANSFERRING SOFTWARE 
A procedure for transferring modules is described below. 


Prior to performing the procedure, the user should, of 
course, determine the modules to be transferred and the unneeded 
elements on the volume to which new software is to be added. 
Section 7 contains a description of the contents of all disks. 


1. Mount the volume containing the modules to be transferred 
on an available drive. 


2. Use a list names command (LS) to ascertain the size of 
the modules to be transferred. 


3. Mount the volume to which the modules are to be 
transferred. 


4. Use an LS command to ascertain the size of unneeded 
elements. 


Dé Release unneeded elements. 


6. Mount a new diskette on an available drive. Use a create 
volume command (CV) to initialize this diskette. (Use a 
temporary, unique volume identifier.) 


7. Use a create directory command (CD) to create appropriate 
directories on the new diskette. 


8. Use a copy command (CP) to copy the remaining contents of 
the volume mentioned in step 3 to the new volume. 


9. Ensure that the volume referenced in step 1 above is 
mounted and uSe a copy command to copy the appropriate 
modules to the new volume.'! 


‘When adding elements to the bootstrap volume, the system builder 
should remember that if a rollout capability is to be estab- 
lished, sufficient space must be available on the volume for the 
ROLLOUT file created during system configuration; this rollout 
file must be large enough to accommodate the batch memory pool. 
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10. 


“Use a CV command to rename the new volume. (If the new 


name duplicates the name of a currently-mounted volume, _ 
the system will issue a dismount message, directing yeu 


to dismount the newly- renamed volume.) 
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APPENDIX A 
STARTUP HALTS 
Startup halts may be classified in three categories: 
e Halts related to bootstrap operation. 
e Error halts related to Configuration Load Manager. 


e Error halts related to other aspects of system 
initialization. 


A halt related to the bootstrap operation may have been 
intentionally requested, or it may reflect an error condition. A 
bootstrap halt is intentionally requested by setting ON bit 13 of 
the 16-bit (four hexadecimal digits) bootstrap channel number 
(see Table 3-2). In the event of this type of bootstrap halt, 
the following register contents are significant: 


e Rl-register contains bootstrap channel number. 


e R2-register contains address mode flag: 0 indicates SAF; 
1 indicates LAF. 


e R3-register identifies the bootstrap device type: 


O indicates cartridge uasn, curtrigc> module disk. or mass 
Storage unit; 1 indicates diskette. 


Error halts during bootstrap result in a 16nn value in the Rl- 
register. See the System Messages manual for a description of 


the 1611, 1612, and 1616 error halts. 


NOTE: If a bootstrap halt occurs with a 16976 error condi- 
tion, there is a possibility that the D7 register will 
contain no error status. To obtain status in such 
circumstances, select D7 prior to retrying the opera- 
tion and observe D7 during bootStrap processing. 
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Error halts related to the Configuration Load Manager result 
in a 13nn value in the Rl-register; usually additional informa- 
tion relative to the halt is available in, or through, other reg- 
isters. See the System Messages manual. Note that if an opera- 
tor terminal is connected to an MDC (and if its DEVICE directive 
has already been read), a Configuration Load Manager error condi- 
tion produces an error message at the operator terminal; in this 
case, a halt occurs (in addition to the message) only under cer- 
tain error conditions. Configuration Load Manager error messages 
are described in the System Messages manual. 


Error halts related to other aspects of system initializa- 
tion result in a 99nn value in the Rl-register; in some cases, 
additional information relative to the halt is available in, or 
through, other registers. See the System MesSages manual. 
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APPENDIX B 


SYSTEM OVERLAYS 


Table B-1 provides a list of all system overlays that can be 
made permanently resident in the system area of memory. Each 
overlay to be made permanently resident must be named in a RESOLA 
directive (described in Section 5). Multiple system overlays can 
be named in a single RESOLA directive. 


Beside each overlay name in Table B-1l iS the approximate size 
(in decimal words) the overlay requires in memory if it is made 
permanently resident. In certain cases, footnotes indicate 
groups of overlays that should all be made permanently resident 
if optimum speed is desired for the related function. Elsewhere, 
in cases where a function is divided into phases, both phases of 
the function should be made permanently resident if optimum speed 
ls desired for that function. 


Table B-l. System Overlays 


Overlay Size 
Name (in Words) Function 


Executive 
Services 


OIOIMS OIM dispatcher (all LRN O orders) 
OIMIMO OIM input processor 


OIOIM1 OIM command processor, output completion, 
and break handler 


OIOIM2 OIM output control 
OIOIM3 OIM diagnostics 


OIOIM4 OIM abort group request purge and OIM 
monitor call handler 


OMSTAT SSTMP (Status memory pool) macro handler, 
and get specific memory block 
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Overlay 


Name 


OOBIND 


OOCROT 


OOMSCO 


OOPACK 


OOROO] 
OOROO2 
OUEML2 
OUERS1 
QUERS 2 
OUERS 3 
OXACSP 
OXAVR1 
OXBXFR 


OXC_IX 


OXCTSK 


OXCKP1 
OXCKP2 


OXCKPA 


Table B-l (cont). 


Function 


Size 
(in Words) 


226 


169 


System Overlays 


Loader —- Processing of relocation items 


Loader - Create OAT and release, wait and 
recall overlay MCL handler 


Loader — Processing of SLIC load units, 
unloading of bound units 


Loader -— Resolution of symbols defined by 
LDBU's and of root entry names 


Loader - Load of bound unit (phase 1) 
Loader - Load of. bound unit (phase ay. 
Error message library processing 


Error reporter (phase 1) 


| Error reporter (phase 2) 


Error reporter: trap errors only 
Break task activation/suspension 
Automatic volume recognition 


Bound-unit transfer MCLS 


Convert from/to external/internal date/ 
time 


Create and spawn task 


Create driver (initialization use only) 
Create and spawn group 


Checkpoint, determination of checkpoint- 
ability and phase 1 of checkpoint 


Checkpoint - phase 2 
Checkpoint - phase 3 


Checkpoint file assignment - part 1 
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OXDFRT 


OXDLGP 


OXDTSK 


OXELOG 
OXESWO 
OXGACT 
OXGSSP 
OXGRQS 
OXGRS 2 
OXGROQT 
OXGRT 2 
OXGRT3 
OXMFO1] 


OXMFO2 


OXMFO3 


OXMF04 


OXMFO5 


OXMFO06 


Table B-1l (cont). System Overlays 


Overlay Size 
Name (in Words) 


OXCKPA2 


474 


St 


448 


488 


393 


370 


398 


Function 


Checkpoint file assignment - part 2, and 
checkpoint file disassignment 


Place deferred spawn task request 
Spawn deferred task (after defer interval) 


Delete/abort group (and abort group 
request) 


Task Deletion (created or spawned tasks) 
Request task deletion (created tasks) 
Error logging MCLS 

External switch handler 

Group activate (rollout phase 2) 

Group suspend (rollout phase 1) 


otart group request (phase 1) 


Group request Startup (phase 2) 


Terminate group request (phase 1) 
Terminate group request (phase 2) 
Group request termination (phase three) 
Message facility: MCL dispatcher 


Message facility task request dispatcher: 
Call MF MCLs 


Message facility activate mailbox; open 
mailbox file (accept and receive - disk 
queuing) ° 

Message facility: accept MCLs 

Message facility: accept,MCLs and read 
record from mesSage facility file (accept 


and receive - disk queuing) 


Message facility. initiate MCLs 
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Overlay 


Name 


-OXMFO7 


OXMF 08 


OXMF 09 


| OXMF 10 


OXMF 11 


OXMF12 


OXPCBU 
OXPCL1 
OXPCL2 


OXPCL3 


OXRQGP 
OXRQG2 


OXRQG 3 


OXRST3 


OXRSTB 


Table B-1 (cont) . 


Size 
(in Words) 


257 


383 


307 


479 


139 


421 


System Overlays 


Function 


slicing gc a ee ee een 


Message facility: send MCLS 


Message facility: send MCLs (disk 
queuing/backup); terminate message MCLS 
(send) 

Message facility: receive MCLs 

Message facility: cancel enclosure level 
MCLs, delete quarantine unit (receive 
MCLs - disk queuing/backup) 


Message facility: terminate message MCLs 


(receive) 

Message facility: close mailbox (all 
terminate message MCLs - disks queuing/ 
backup; initiate MCLs -—- disk queuing; mes- 
Sage count MCLs) terminate message MCLS 
(waiting acceptor) 
Process command line: activate functions 
Process command line (phase 1) 

Process command line (phase 2) 


Process command line: break interrupt 


handler 
Request and spawn group (phase 1) 
Request and spawn group (phase 2) 


Request and spawn group (when mailbox 
queued request) 


Restart phase 1l 
Restart pnase Z 
Restart phase 3 
Restart phase 4 
Restart phase 5 


Restart -— terminal substitution 
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Table B-1 (cont). System Overlays 


File Management 


; Name (in Words) Function 
OXRSTF 488 Restart phase 6 (last) 
OXRSTH 164 Restart - Sound units preservation 
OXRSTP 317 Restart - trap processing and suspension 
activation during restart 
OXRSER 495 Restart - error processing 
OXSIO1 319 Standard input/output (new uSer, 
command in) 
OXSIO2 275 Standard input/output (new user, user out) 
OXSIO3 186 Standard input/output (input line 
expansion) 
OXSIO4 119 Standard input/output (system error out 
handler) 
OXSMCL 200 Process semaphore MCLS 
OXTR17 204 Defective memory trap handler 
OXTRPO 315 Connect uSer trap handler (enable, disable 
user traps) 
OXTRR 139 Terminal request handler 
OXUPFO 265 Identification/information macros 
OXUPF1 188 Identification/information macros 
OXWCS 1 62 Load Writable Control Store 
OXWTLO 296 Wait list processing 

OYASF 97 Associate/disassociate file - MCL 

OYCRF 358 Create file -— MCL 

OYCRR 295 Create record descriptors —- MCL 

OYDLF 506 Delete file -— MCL 
( OYLKF 388 Link file - MCL 


B= 5 CB 23-03 


Table B-1 (cont). System Overlays 


Overlay Size 
Name (in Words) Function 


OYMDF 428 Modify disk file attribute/name - MCL 

OYULF 247 Unlink file - MCL 

OZALX 292 Allocate disk space - record extent in 
directory 

OZALX2 459 Allocate disk space - get space for one 
extent 

OZCRF2 408 Create file -— primary/alternate index 
parameter 

OZCRFE 3 298 Create file - calc/ids-2 parameter 

OZCRF 4 259 Create file - permanent file 

OZCRF5 427 Create file - temporary file and 
subroutines 

OZCRR2 Sat Build record descriptor 

OZLKDR — 248 Link and rewrite directory record 

OZULDR 107. Unlink directory record 

OYGIDV 83 Set device information -— MCL 

OYGIF 506 Get file information - MCL 

OYGTF 403 Get file - MCL 

OYRMF 390 Remove file — MCL 

OZGTF 2 217 Get file - save/restore interface 

OZGTF3 442 | Get file - tape parameter processing 

OZCDDB 313 Get file —- create device descriptor block 
(DDB) 

OZCFDB 509 Get file - create file descriptor block 
(FDB) 

OZGFCB 504 Get file - get file control block (FCB) 

| OZGTRF 277 Get file - get related files 
OYOPNI 443 Open file - MCL 
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Overlay 
Name ( 


OZOPFD 
OZOPFF 


OZOPFU 


OYCLSI 
OZCLED 
OZGRPT 
OYAC] 
OZAC12 
OYAVR 
OYCMR 
OYIT 
OYSWP 
OZAVR2 


OZAVR3 


OZVMT 


OZVMT2 


OZVMT3 
OYCWD 
OYXPA 
OYSTTY 


OYWTF 1 


Table B-1 (cont). 


Size 
in Words) 


System Overlays 


Function 


em ars escent puma casas aes ge ra Ee ee 


Open file - device files 
Open file - fixed relative file 


Open file - sequential/relative/alternate 
indexes 


Close file - MCL 

Close file - device files 

Group termination 

Set/delete access control (ACL) - MCL 
Set/delete access control (ACL) - set ACL 
Automatic volume recognizer (AVR) - MCL 
Cancel mount request (CMR) - MCL 
Initialize tape (IT) - MCL 

Swap volume —- MCL 

AVR - device file other than tape 


AVR - initialize disk volume descriptor 
block (VDB) 


Volume mount - request disk volume mount 


Volume mount - request device/tape volume 
mount 


Volume mount - search for free tape 


Change working directory - MCL 


e 


Expand file pathname —- MCL 


set TTY - MCL 


Wait file -— MCL 


Table B-l (cont). System Overlays 


Overlay Size \ 
Name (in Words) Function 


ca 


Storage Management 


OZSME 181 I/O error handler - common to all files 

OZSME1 181 I/O error handler - disk files 

OZSME2 222 I/O error handler - message handler 

OZSMT 111 Storage management positioning function 
for tape 

OYBPCR 506 Buffer pool - create/delete (MCL) 

OYGIBP 227 Buffer pool - statistics (MCL) 

OZBF2I 287 Buffer pool - flush buffers and disasso- 


Data Management 


Ciate buffers 


OYDMR2 167 Fixed relative —- MCL (read/write/rewrite/ 
delete record) 

OYDMR3 203 UFAS relative - MCL (read/write/rewrite/ 
delete record) 

OZ DMR 284 UFAS relative - positioning 

OYDMS1 255 String - MCL (read/write/rewrite record) 

OZDMS 2 opie UFAS sequential - MCL (rewrite/delete 
record) 

OZACCB 173 UFAS indexed/random - allocate CCB 
(Currency control) 

OZUCCB 448 UFAS indexed/random - update CCB (currency 
control) 

OZ USUB 242 UFAS indexed/random - common subroutines 

OYDMI1 510 Primary indexed - MCL (read/rewrite 
record) 

OYDMI2 299 Primary indexed —- MCL (write record in 
load mode) 

OYUPI1 476 Primary indexed - MCL (insert/delete 


record) 
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Table B-l (cont). System Overlays 


Overlay Size 
Name (in Words) Function 


a i ea ON ae a a ee ee ed 


OZIEXT Primary indexed - initialize for extend 
mode 

OZIOPF Primary indexed - open and close 

OZIPSN Primary indexed - positioning 

OYDMC Calc - MCL (read/write/rewrite/delete 
record) 

OZCER Cale - error processing 

OZCINV Calc - inventory procesSing 

OZC KEY Calc - hash/compare key 

OZCLNK Cale - link/unlink calc record 

OZCOPF Calc - open 

OZCPSN Calc - locate/position record 

OZCSUB Calc - subroutines 

OZ DMC Cale - record modification 

OYDMX1 Alternate index — MCL (read/write/rewrite/ 


delete record) 

OZ DMX Alternate index - update alternate indexes 
OZ XENT Alternate index - add/delete index entries 
OZXER Alternate index - error processing 

OZXLV1 Alternate index - create index levels 
OZXPSN Alternate index - positioning function 
OZXSP1l Alternate index - split CI 

OZXSUB Alternate index - Subroutines 


OYDMX2 Alternate index - MCL (read/write/rewrite/ 
: delete entry) 


| OYDMT Tape - MCL (read/write record) 


OZ DMT Tape - spanned record (read and write) 
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Table B-l (cont). System Overlays 


| Overlay Size | 
| Name (in Words) |. Function 


OZTCLF 285 Tape - close 

OZTEBC 276 Tape - EBCDIC and ASCII conversion 

OZTE XD 469 Tape - expiration date checking 

OZTOP1 483 Tape - open (common) 

OZTOP2 512 Tape - labeled tape 

OZTOP3 316 Tape - unlabeled tape 

OZTOP4 491 Tape - process tape labels 

OZTPSN 279 Tape - positioning 

OZTSUB 237 | Tape - Subroutines, ASCII and binary 
conversion 

OZTUT1 | 380 Tape - subroutines 


Checkpoint, Restart, Record Lock, and Recovery Services 


OYCKPT 293 Checkpoint —- MCL 

OZCKER 427 Checkpoint - error reporting 

OZCKPT 479 Checkpoint - internal check point 

OYRSRT — 6-438 | Restart - MCL 

OYUREC 293 Unlock record — MCL 

OZBEF 312 * Before image - data management interface 
OZBISF 255 Before image - reservation 

OZBILR 41? Before image - initialization 


image offline recovery 


OZBIWR image - write before image 


OZCLPT Clean point - MCL 


OZROLB Roll back 
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Table B-1 (cont). System Overlays 


aThis overlay should be made permanently resident if optimum 


speed is desired in processing UFAS indexed files. 


bThis overlay should be made permanently resident if optimum 
speed is desired in processing UFAS relative files. 


“This overlay should be made permanently resident if optimum 
speed is desired in processing UFAS random files. 


dThis overlay should be made permanently resident if optimum 
speed is desired in processing indexed and random files, and 
alternate indices. 


°This overlay should be made permanently resident if optimum 
speed is desired in processing files with alternate indices. 


‘This overlay should be made permanently resident if optimum 
speed is desired in processing UFAS tape files. 


9This overlay should be made permanently resident if optimum 
speed is desired in processing EBCDIC tape functions. 


hThis overlay should be made permanently resident if optimum 
speed is desired in processing using record locking/recovery. 


i'This overlay should be made permanently resident if optimum 
speed is desired in processing file management functions. 


iThis overlay should be made permanently resident if optimum 
speed is desired in processing using buffer pool management. 
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APPENDIX C 


EQUIPMENT REQUIREMENTS 


This appendix contains minimum system guidelines and a list 
of supported equipment. 


MINIMUM SYSTEM GUIDELINES 


Minimum system guidelines are offered as aids to system 
builders who must determine the resources required to perform 
meaningful processing at the installation. Minimum system guide- 
lines provide base configurations from which the system builder 
can calculate what additional memory and peripheral devices (if 
any) are necessary for efficient and effective operations. These 
guidelines will remain in effect until the next major release of 
MOD 400. 


Minimum System for Program Development 


Program development activity in a single-user environment can 
be accomplished with 64K words of memory (SAF or LAF) and a 
compliment of peripheral devices limited to the following: one 
operator terminal, one printer, and up to four cartridge disks, 
cartridge module disks or mass Storage units. 


In such an environment, the user can obtain an online memory 
pool of 38K words (remaining memory would be required to accom- 
Modate the resident executive and a 6K-word system memory pool). 
Additionally, this minimum system would allow the user to provide 
for the following exhaustible resources: two system overlay 
areas, 17 trap save areas, and 30 intermediate request blocks. 


Minimum System for Online Applications (Execute-Only) SAF Mode 


A configuration with 48K words of memory (SAF mode) and a 
compliment of peripheral devices limited to those described below 
will permit the execution of a wide variety of user applications 
in a single-user environment.! 


7The 2780/3780 Workstation Facility can be used in an environment 


as described above with 32K words of memory. 
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e Two disks! 
@e One printer 


@e One teleprinter-compatible terminal connected to an MLCP 
or DLCP 


e <A PVE link 


In such an environment, the user can obtain an online memory 
pool of 13K words (remaining memory would be required for the 
resident executive and a 6K word system memory pool). Addition- 
ally, this minimum system would allow the user to provide for the 
following: the commercial simulator, two system overlay areas, 
17 trap save areas, and 30 intermediate request blocks. 


Minimum System for Online Applications (Execute-Only) LAF Mode 


A configuration with 64K words of memory and a compliment of 
peripheral devices limited to those described below will permit 
the execution of a wide variety of user applications in a single- 
user environment .? 


e Two disks' 
e One printer 


@ One VIP7200/05 or VIP7801/02 terminal connected to an MLCP 
or DLCP 


e A PVE link 


In such an environment, the user can obtain an online memory 
pool of 16K words (remaining memory would be required for the 
resident executive and a 6K word system memory pool). Addition- 
ally, this minimum system would allow the user to provide for the 
following: two system overlay areas, 17 trap save areas, 30 
intermediate request blocks and the Display Formatting and 
Control Facility software. 


1In an all-diskette system, it is recommended for ease-of-use 


that four diskettes be selected. 


2The 2780/3780 Workstation Facility can be used in an environment 
as described above with 32K words of memory. 
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SUPPORTED HARDWARE 


Table C-l1 lists Level 6 equipment and options supported by 
MOD 400 when operating on the Model 23 central processor. 
Table C-2 lists the Level 6 equipment and options supported by 
MOD 400 on other central processor models.' 


Table C-l1. Supported Hardware - Model 23 


Marketing 


Category Identifier Description 


Central CPS9351 23 Minimount, 32K, FCP, 
Processors no-disk 

CPS9352 23 Minimount, 32K, FCP, 
no-disk 

CPS9353 23 Minimount, 64K, FCP, 
no-disk 

CPS9354 23 Minimount, 64K, FCP, 
no-disk 

CPS9356 23 Minimount, 32K, S-slot, 
no-disk 

CPS935/7 23 Minimount, 32K, |} 9-slot, 
no-disk 

CPS9358 23 Minimount, 64K, 5-slot, 
no-disk 

CPS9359 23 Minimount, 64K, 9-slot, 
no-disk 

CPS9370 23 Minimount, 32K, 7-slot, 
cartridge module 

CPS9371 23 Minimount, 64K, 7-slot, 
cartridge module 

CPS93/2 23 Minimount, 64K, 7-slot, 
cartridge module 

CPS9373 23 Minimount, 32K, 7-slot, 
cartridge module 

CPS9374 23 Minimount, 64K, 7-slot, 
cartridge module 

CPS9375 23 Minimount, O4K, 7-slot, 
cartridge module 


TThese tables are not a complete listing of Level 6 equipment. 
In some cases (e.g., cabinetry, cables), equipment is not listed 
because its use is inviSible to the software; in other cases, 
equipment is not listed because full software qualification had 
not been performed at the time this document was published. 
Information relative to the operation of GCOS 6 MOD 400 on 
equipment not listed can be obtained from Honeywell Marketing 
Representatives. The user should also note that these tables 
contain no information with respect to installation prerequi- 
sites. You cannot use these tables to configure end-user 
systems. 
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Table C-1 (cont). Supported Hardware - Model 23 


: Marketing | 
Category Identifier Description 
Console KCM9301 Single console adapter 
Adapters KCM9302 Dual console adapter 


Consoles DKU9101 VIP 7100 console, 64-character set 


DKU9102 VIP 7105 console, 96-character set 
DKU9103 VIP 7200 console, 64-character set 
DKU9104 VIP 7205 console, 96-character set 
TWU9104 30CPS console typewriter 
TWU91O06 120CPS console typwriter 
TWU9108 30CPS console with numeric keypad 
TWU9110 120CPS console with numeric keypad 
Printer PRM9301 M23 printer adapter 
ee 
Line PRU9103 Z240LPM printer; 96-character set 
Printers PRU9104 300LPM printer; 64-character set 
PRU9105 440LPM printer; 96-character set 
PRUI106 600LPM printer; 64-character Set 
PRU9108 660LPM printer; 96-character set 
PRUQ109 90O0LPM printer; 64-character set 


Matrix printer; 120CP5 


PRU9Q112 
PRU9Q114 Matrix printer; l160CPS 
DIM9301 M23 diskette adapter 


DIU9101 Single-diskette (Single-sided) ; 


Matrix 
Printers 


Diskette 
Adapter 


Diskettes 


256KB 
DIU9102 Dual-diskette (single-sided); 
2x256KB 
DIU9103 Single-diskette (double-sided); 
512KB 
DIU9104 Dual-diskette (double-sided); 
2x512KB 
Cartridge CDS9336 26MB cartridge modute disk in cabi- 
Module Disks net with 23 controller 
CDS9337 2x26MB cartridge module disk In 
cabinet with 23 controller 
CDS9338 80MB cartridge module disk in cabi- 
net with 23 controller 
CDS9339 2x80MB cartridge module disk in 
cabinet with 23 controller 
CDU9136 26MB cartridge module disk in cabi- 
net without controller 
CDU9137 2x26MB cartridge module disk in 


cabinet without controller 
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Table C-l (cont). Supported Hardware - Model 23 


Marketing 
Category Identifier Description 


CDUI1 38 80MB cartridge module disk in cabi- 
net without controller 

2x80MB cartridge module disk in 

cabinet without controller 


Cartridge 
Module Disks 
(cont) 


CDU91 39 


DCM9 301 M23 communication adapter; 2 asyn- 
chronous lines 

M23 communication adapter; 1 syn- 
chronous line 

M23 communication adapter; 2 syn- 
chronous lines 

M23 communication adapter; 1 syn- 

chronous and 1 asynchronous line 


Communication 
Adapters 


DCM9 302 


DCM9 30 3 


DCM9 304 


Asynchronous 
Terminals 


Terminals 


VIP7100 CRT terminal, 64-character set 


VIP7105 CRT terminal, 96-character set 
VIP7200 CRT terminal, 64-character set 
VIP7205 CRT terminal, 96-character set 
VIP7801 CRT terminal, 12-inch screen 
VIP7802 CRT terminal, 15-inch screen 
VAF7821 Buffered printer adapter for all 


VIP 7800 terminals 


TWU1001 Keyboard/printer, 30 cps 
TWU1003 Keyboard/printer, 30 cps 
TWU1005 Keyboard/printer, 120 cps 
PRU1LOOL Printer terminal, 30 cps 
PRU1003 Printer terminal, 30 cps 


PRU1LOO5 Printer terminal, 120 cps 


Synchronous 
Terminals 


VIP7700 
VIP7705 
VIP7700R 
VIP7705R 


CRT terminal, 62-character set 
CRT terminal, 95-character set 
CRT terminal, 63-character set 
CRT terminal, 95-character set 


VIP7760 
Subsystem 


CRT terminal, 95-character set 


VIP7804 
VIP7805 
VAF 7821 


CRT terminal, 12-inch screen 

CRT terminal, 15-inch screen 

Buffered printer adapter for all 
VIP 7800 terminals 


ROP Printers | ROP printers are generally supported 
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Table C-1l (cont). Supported Hardware - Model 23 


Modems Modems supported for asynchronous communications 
terminals are: 


@ 0s. hie 202 type modems. (These modems must be 
equipped with the option to disconnect the data set 
after a carrier drop of 110 milliseconds.) 


e Honeywell modem bypass. 


e Modem types where the connection, disconnection, and 
data set control settings can be user-specified. 


Modems Supported for synchronous communications 
terminals are: 


e 201, 201A, 201C, 208, and 208B type modems. 
@e Honeywell modem bypass. 


e Modem types where the connection, disconnection, and 
data set control settings can be uSer-Specified. 


e Broadband modem. 


A modem iS not required for a direct-connect asynchro- 
nous terminal, or a synchronous terminal with a timing 
source in the terminal or in the MLCP. 


system Writable Control Store (CPF9509) is offered for system 
Building | builder use only. Although Writable Control Store is 
Products |uSable under GCOS 6 MOD 400, full end-user software 


Support 1S not available. 
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Table C-2. Hardware Supported - Model 3X, 4X and 5X 


( Marketing 
. Category Identifier Description 


Central CPS9470 Model 33 Central Processors; 
Processors CPS9471 memory to 64K words 
CPS9472 
CPS9473 


CPS9560 Model 43 Central Processors; 
CPS9561l memory to 1024K words 
P5962 

CPS9563 


CPS9566 Model 47 Central Processors; 
CPS9567 Commercial Model; memory to 
1024K words 


CPS9570 Model 53 Central Processors; 
includes MMU and Cache; memory 
to 1024K words 


CPS9572 Model 57 Central Processor; 


Commercial Model with MMU and 
Cache; memory to 1024K words 


| Multiple Device | MDC9101 Multiple device controller 
Controller | 

Console KCM9101 Keyboard console device-pacs 

Device-pac 


DKUQ101 VIP 7100 console 


Consoles 


DKU9102 VIP 7105 console 

DKU910 3 VIP 7200 console 

DKU9104 VIP 7205 console 

TWU9104 300CPS console typewriter 

TWU91O06 120CPS console typewriter 

TWU9108 30CPS console with numeric keypad 
TWU9110 120CPS console with numeric keypad 


Printer 
Device-pac 


~ PRM9101 Printer device-pac 


Line Printers 


PRUS9103 24Q0LPM, 96-character set 
PRU9I104 300LPM, 64-character set 
PRU9105 | 440LPM, 96-character set 
PRUQ106 OOOLPM, 64-character set 
PRU9108 660LPM, 96-character set 
PRU9109 


900LPM, 64-character set 


120CPS matrix printer 
| 160CPS matrix printer 


Matrix 
Printers 


PRUQ112 
PRUI114 
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Table C-2 (cont). Hardware Supported - Model 3X, 4X, and 5X 


Marketing 
Category Identifier Description 
Card Reader CRM9101 Card reader device-pac | 
Device-pac 


Card Readers CRU9108 300C PM 
CRUI9109 300CPM, sense 
CRU9110 300CPM, sense 
CRU9111 500CPM 
CRU9112 500CPM, sense 
CRU9113 500CPM, sense 
Card Punch and CRM9103 
Card Reader/ 
Punch Device- 
Pac (Adapter) 


Card Punch PCU91OL Card punch, 100 cpm 
Card Reader/ CCU91OL Card reader/punch, 400/100 cpm 
Punch 


Diskette DIM9101 
Device-pacs 


Diskettes 


Cartridge Disks 


Device-Pac for card punch and card 
reader/punch 


Diskette device-pac for 2 single- 
Sided diskettes 

Diskette device-pac for (2) l- or 

2-sided diskettes 


DIM9102 


DIU91OL Single diskette (single-sided), 


256KB 

DIU9102 Dual diskette (single-sided) , 
2X256KB 

DIU9103 Single diskette (double-sided) , 
512KB 


DIU9104 Dual diskette (double-sided), 


2x512KB 


CDU9116 10MB (5+5) cartridge disk with 
controller 
1OMB (5+5) additional disk without 


controller 


CDS9116 


ev 


Cartridge CDS9136 26MB (13F + 13R) in cabinet with 
Module Disks controller 
CDS9137 26MB in cabinet with controller 
CDS9138 80MB (67F + 13R) in cabinet with 
controller 
CDS9139 Dual 80MB in cabinet with 
controller 
CDU9136 26MB in cabinet without controller 
CDU9137 Dual 26MB in cabinet without 
controller 
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Table C-2 (cont). Hardware Supported - Model 3X, 4X, and 5X 


Marketing 
Category Identifier Description 


Cartridge CDU9138 80MB in cabinet without controller 
Module Disks CDU9139 Dual 80MB in cabinet without 
(cont) controller 


CDS 9123 26MB (13F + 13R) with controller 
CDS9125 80MB (67F + 13R) with controller 
CDU9123 26MB add-on unit without 


controller 
80MB add-on unit without 
controller 


CDU9125 


Mass Storage unit in cabinet with 
controller 

256MB mass storage unit in cabinet 
with controller 

Dual 67MB mass storage units in 
cabinet with controller 

67MB mass storage add-on unit 
without controller 

256MB mass storage add-on unit 
without controller 

Dual 67MB mass storage add-on unit 

without controller 


Mass Storage MSS9102 


Units 


MSS9104 


MSS9107 


MSU9102 


MSU9104 


MSU9107 


Magnetic tape controller, NRZI 
drives 

Magnetic tape controller, PE/NRZI 

drives 


Magnetic Tape MTC91O1 


Controllers 


MTC9102 


Magnetic tape Device-Pac, 7-track 
drives 

Magnetic tape Device-Pac, 9-track 

drives 


Magnetic Tape MTM9101 


Device-Pacs 


MTM9102 


MTU9104 Magnetic tape drive, 9-track NRZI, 
45 inches per second (ips) 

Magnetic tape drive, 9-track NRZI, 
75 ips 

Magnetic tape drive, 9-track NRZI/ 
PE, 45 ips 

Magnetic tape drive, 9-track NRZI/ 
PE, 75 ips 

Magnetic tape drive, 7-track NRZI, 
45 ips 

Magnetic tape drive, 7-track NRZI, 
75 ips 

Magnetic tape drive, 9-track PE, 
45 ips 

Magnetic tape drive, 9-track PE, 

75 ips 


Magnetic Tape 
Drives 


MTU9105 


MTU9109 


MTU9110 


MTU9112 


MTU9113 


MTU9114 


MTU9115 
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Table C-2 (cont). 


Category 


Communication 
Controllers 


Communications-—- 


Pacs 


MLC9103 
MLC91O1 


MLC9102 


MLC9104 


DCM9101 
DCM9102 
DCM910 3 
DCM9104 


DCM9105 


DCM9106 
DCM9108 
DCM9109 


DCM9110 


DCM91I11 


DOCOMO AZ 


DCM9113 


DCM9114 


DCM9115 


DCMYi16 
DCM9120 
DCM9121]1 


DEMO 126 


Hardware Supported - Model 3X, 4X, and 5X 


Marketing 
Identifier 


Description 


Multiline communications processor 

MLCP with 8 asynchronous lines; 
includes 4 communication-pacs 

MLCP with 8 synchronous lines; 


includes 4 communication-pacs 
MLCP with 8 current loop lines; 
includes 4 communication-pacs 


Communications-pac, two asynchro- 
nous lines, cable 

CommunicationS-pac, one asynchro- 
nous line, cable 

CommunicationsS-pac, two synchro- 
nous lines, cable 

Communications-pac, one synchro- 
nous line, cable 

CommunicationS-pac, one current 
loop line (Bell 301/303 modem 
compatible) 

CommunicationS-pac, one medium 
Speed, synchronous, HDLC line 
Communications-pac, broadband line 

(CCITT/V35 compatible) 
CommunicationsS-pac, two synchro- 
nous lines (MIL 188C compatible) 
Communications-pac, Autocall Unit 
for one or two synchronous or 
asynchronous lines 
Communications-pac, one asynchro- 
nouS current loop line 
Communications-pac, broadband EDLC 
line (Bell 301/303 modem compat- 
ible to 72KB) 


Communications-pac, broadband HDLC 


line (CCITT/V35 compatible to 
72KB) 


Communications-pac, two asynchro- 


nouS current loop lines 

CommunicationS-pac, broadband syn- 
Chronous line (MIL 188C compat- 
ible to 56KB) 


| Communications-pac, two asynchro- 


nous lines (MIL 188C compatible) 

Communications-pac, HDLC to 19 2KB 
MIL 188C 

CommunicationS-pac broadband HDLC 
MIL 188C 

Communications-pac INCOTERM 
connection 
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Table C-2 (cont). 


Terminals 
{ 


Marketing 
Identifier 


Asynchronous 
Terminals 


VIP7100 
VIP7105 
VIP7200 
VIP7205 
VIP7801 
VIP7802 
VAF7821 


TWU1LOOL 
TWU1003 
TWU1005 
PRU1LOOIL 
PRU1003 
PRU1OO5 


Synchronous 
Terminals 


VIP7700 
VIP7705 


VIP7700R 
VIP7705R 


VIP7760 


Subsystem 


VIP7/804 
VIP7805 
VAF7821 


ROP Printers 


Hardware Supported —- Model 3X, 4X, 


Description 


terminal, 
terminal, 
terminal, 
terminal, 
terminal, 
terminal, 


64-character 
96-character 
64-character 
96-character 
12-inch screen 

15-inch screen 

Buffered printer adapter for all 


VIP 7800 terminals 


Keyboard/printer, 
Keyboard/printer, 
Keyboard/printer, 
Printer terminal, 
Printer terminal, 
Printer terminal, 


CRT 
CRT 
CRT 
CRT 


CRT 


CRI 


30 cps 
30 cps 
120 cps 
30 cps 
30 cps 
120 cps 


and 5X 


set 
set 
set 
set 


terminal, 
terminal, 
terminal, 
terminal, 


terminal, 


62-character 
95-character 
63-character 
95-character 


95-character 


set 
set 


Set 
set 


set 


terminal, 


CRT terminal, 


ROP printers are generally 
supported 


12-inch screen 
15-inch screen 
Buffered printer adapter for all 
VIP 7800 terminals 
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Table C-2 (cont). Hardware Supported - Model 3X, 4X, and 5X 


Modems Modems supported for asynchronous communications 
terminals are: 


e@ 103, 113, 202 type modems. (These modems must be 
equipped with the option to disconnect the data set 
after a carrier drop of 110 milliseconds.) 


e Honeywell modem bypass. 


e Modem types where the connection, disconnection, and 
data set control settings can be user-specified. 


Modems supported for synchronous communications 
terminals are: 


e 201, 201A, 201C, 208, and 208B type modems. 
e Honeywell modem bypass. 


e Modem types where the connection, disconnection, and 
data set control settings can be user-specified. 


e Broadband modem. 


A modem is not required for a direct-connect asynchro- 
nous terminal, or a synchronous terminal with a timing 
source in the terminal or in the MLCP. 


*; System Writable Control Store (CPF9509) is offered for system 

Building | builder use only. Although Writable Control Store is 
*| Products |uSable under GCOS 6 MOD 400, full end-user software 
Support 1S not available. 
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APPENDIX D 


POWER RESUMPTION 


NOTE: The Power Resumption facility is not Supported on 
systems with an MLCP-connected operator's console. 


The power resumption facility allows the system execution 
environment to be restarted after a power interruption. The 
central processor must have the memory save and autorestart unit. 
This unit can preserve the memory image through a power failure 
lasting up to two hours. It cannot, however, preserve the state 
of the I/O controllers, ensure that no operational changes have 
been made to the mounted volumes, nor preserve the contents of 
the multiline communication processors. Restoration of this 
system information is accomplished through the power resumption 
facility. 


If fewer than two hours have elapsed when power is returned 
to the central processor, the power resumption facility performs 
the following actions: | 

e Reinitializes the I/O controllers 

e Reconnects terminal devices (TTY and ATD devices) 


e Reestablishes the integrity of mounted volumes 


e Restarts the communications subsystem (TTY and ATD devices 
only) 


e Restarts the application tasks that were active at the 
time of the failure 


e Signals a power resumption software trap to tasks that 
have a handler enabled for this trap 


e Restarts Display Formatting and Control processing 
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If the power remains off for more than two hours, the memory 
image is destroyed and the power resumption facility is disabled. 
The "memory on" indicator contained in the memory save and auto- 
restart unit is lit. The operator must manually reset this indi- 
cator before rebootstrapping the system to perform a restart. 

See the Level 6 Minicomputer Systems Handbook for detailed infor- 
mation about the memory Save and autoresStart unit. See the 
Operator's Guide for procedures used in restarting after a system 
failure. 


POWER RESUMPTION CONFIGURATION REQUIREMENTS 


To implement the power resumption capability, you must con- 
figure the following: 


e Memory Save and autorestart unit 
@e Power resumption facility 
e Automatic terminal reconnect 


Note that peripheral devices (those devices not attached to 
an MLCP) are deSignated automatically reconnectable when they are 
configured at system building. These devices are reconnected 
when power is restored. 


Configuring Memory Save and Autorestart Unit 


Four small rocker switches, located behind the full control 
panel on the control panel circuit board, supply configuration 
information to the central processor. The switch on the extreme 
left (when the panel is open) is the volatile memory switch. It 
must be set off (pushed down) to inform the system that the 
memory Save and autoreStart unit is present. 


NOTE: On some control panels, the volatile memory switch is 
on the extreme right. See the Level 6 Minicomputer 
Systems Handbook for complete details. 


Configuring Power Resumption Facility 

You add the power resumption facility to your system by 
including the following LDBU directive in the Configuration Load 
Manager (CLM) file. 

LDBU ZXPFR 


see Section 5 for a description of the LDBU directive. 


Configuring Automatic Terminal Reconnect 


Bach communication device (each terminal connected to an 
MLCP) that is to be automatically reconnected by the power 
resumption facility must be so designated using the STTY command 
with the -—RECONNECT argument in your CLM file. See the descrip- 
tion of the STTY command below. 
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( STTY 


STTY COMMAND 
Command Name: STTY 


Change or display the file characteristics of a communications 
terminal. Can be used as an alternative to the STTY directive 
format in the Configuration Load Manager (CLM) file. Provides 
features not supported by the STTY directive. You must include 
an STTY command in your CLM file for each terminal that you 
wish to configure as being reconnectable in the event of a sys- 
tem power failure. 


FORMAT: 
STTY [device name] ctl arg 
ARGUMENT DESCRIPTION: 


device name 


The 1l- to 6-character device name of the terminal; use of 
the exclamation point character as a prefix is optional 
(e.g., TTYO1L or !TTYO1 can be used). 

Default: The terminal from which this command is issued. 


ctl arg 


One or more of the following control arguments must be 
Specified, in any order. If an argument is unspecified, 
the corresponding current value for the terminal remains 
in effect. 


-LL n 


Decimal integer specifying the desired line length. 
This value excludes the control byte. 


I 
-TYPE < O 
B 


Set the device type to input-only (1), output-only 
( | (O), or bidirectional (B). 


D-3 CB 23-03 


-TABSIM toe 


-IN 


NO 


Insert Space characters, where needed, to simulate 


tabbing. If the terminal does not support tabbing 
and the output data has tab characters, specify YES. 


Prepare the device to receive asynchronous buffered 
(A), synchronous buffered (S), or nonbuffered syn- 
chronous (N) input. (See the " Function Description" 
for a description of asynchronous, synchronous, and 
buffered.) 


A 
-OUT S 
N 


-~RECONNECT te 


Prepare the device to transmit asynchronous buffered 
(A), synchronous buffered (S), or nonbuffered syn- 
chronous (N) output. (See the "Function Description" 
for a description of asynchronous, synchronous, and 
buffered.) 


NO 


Specifies whether or not this terminal should be 
automatically reconnected following a power failure 
or line drop condition. If YES is specified, the 
terminal will be automatically reconnected. If NO is 
specified, no automatic reconnection will take place. 
The default is NO.~- 


-PRINT 


Display the current characteristics (name, device- 
type, line length, etc.) for the terminal. | 


~MODES mode ees 


Mode 
ECHO 


ens 
AC 


acid 
TR 


STOP OUTPUT 
SO 


LINE_FEED | 
LF 


ARRIAGE_RE 
R 


CONTROL BYT 
CB 


ren 
HU 


HOME 


1The ATD LPH 
protocol ha 
bilities (e 
port of the 
handler cal 


Set the terminal to operate in the specified mode(s). 
To reset a mode, precede the mode with a circumflex 
(“). For example, -MODES ECHO,” HANG UP sets the ter- 
minal to echo keyboard input and to "not" hang up the 
phone when the file is closed. Any number of modes 
can be set or reset in any combination, in any order. 
If a particular mode is not specified, that mode is 
not changed. Possible modes are listed below. To 
set a mode, you must Know which line protocol handler 
(LPH) is servicing the terminal. The -PRINT argument 
can be used to display the current mode settings to 
determine which modes can be set or reset. 


Meaning LPH 
Echo keyboard input. TTY ;ATD 


Use the Auto-Call unit when the ALL. 
file is opened. 


\ Input data is in transparent TTY ,ATD,BSC 
mode. 
If an output order is in prog- TTY ,ATD 
ress, stop it immediately if a 


BRK is issued from the terminal. 


Line feed at end of mesSage. TTY,ATD,VIP, 
STD 

ia Carriage return at end of TTY,ATD,VIP, 
message. STD 

F} Output sent to the terminal TTY,ATD,VIP, 
Starts with a control byte. STD, BSC 
Data transfer is in buffered TTY,ATD 
(block) mode, not character 
mode. 


Hang up the phone when the file ALL 
is closed. 


set cursor to home on page VIP,STD 
overflow. 


is intended as a replacement for the V7200 LPH. The 
ndler called by ATD offers additional support capa- 
-9-, block mode support of VIP7801/02 devices, sup- 
VIP7207 device) not offered by the line protocol 
led by V7200. The V7200 LPH may still be used. 
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Mode 
FCTN 


DEL 


Meaning LPH 
Support VIP function codes. VIP,STD,PVE 


Include received DEL characters. PVE 


The following special keywords can be used with 
the VIP line protocol handler to set various 
time-out and polling intervals: 


PI 4 


PI5 


PI15 


PI 30 


Time-out immediately (after 1 VIP,STD 


poll). 
Time-out after 10 minutes of VIP,STD 
polling. 


No time-out (i.e., indefinite). VIP,STD 


No polling interval (li.e., VIP,STD 
continuous). 

l-second poll interval. VIP,STD 
2-second poll interval. VIP,STD 
3-second poll interval. | VIP,STD 
4-second poll interval. VIP,STD 
5-second poll interval. VIP,STD 
15-second poll interval. ViLP,STD 
30-second poll interval. VIP,STD 


-RESET 


Reset the modes to those deSignated at system 
building. 


DSW1 h 


Set the terminal's device-specific word to be used at 
open (connect) and close (disconnect) time; this 
argument iS an alternative to uSing the -MODES argu- 
ment. h is a 4-character hexadecimal value. This 
argument requires detailed knowledge of terminal I/0 
and should be used only if you understand line proto- 
col handlers and have read the Communications 


Processing manual. 
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-DSW2 h 


Set the terminal's device-specific word to be used 
when the file is read or written; this argument is an 
alternative to uSing the -MODES argument. h is a 4- 
character hexadecimal value. This argument requires 
detailed knowledge of terminal I/O and should be used 
only if you understand line protocol handlers and 
have read the Communications ProcesSing manual. 


NOTES: 1. Only the current device-specific word 
assignments can be modified; i.e., not 
the initial device-specific words estab- 
lished through the STTY directive during 
system building. 


2. No consistency checks are made; if the 
-DSW1 or -DSW2 argument specifies logi- 
cally inconsistent or impossible condi- 
tions, relative to the actual device 
type, no notification of error is given 
and the indicators are set as requested. 


FUNCTION DESCRIPTION: 


The set terminal characteristics (STTY) command permits you 
to modify or display the file characteristics associated with 
a terminal or endpoint that is not currently reserved. The 
original terminal characteristics, established during system 
building, can be altered to reflect your current needs. To 
use the -IN and -OUT arguments, you must understand the 
meanings of the terms buffered, asynchronous, and synchro- 
nous. These terms are described below. 


Buffered means that an intermediate data storage area is used 
before data is transferred to/from a device. For input, data 
is received in system memory and then moved to user memory. 
For output, data 1S moved from user memory to system memory 
and then to the device. Nonbuffered means that data is 
transferred directly from user memory to the device. 


Asynchronous data transfer is the concurrent transfer of data 
and execution of an application program; i.e., processing can 
continue during a read/write operation. Asynchronous opera- 
tions are always buffered. 


In synchronous data transfers, processing waits for comple- 
tion of a read/write request. Control returns to the 
requestor after the transfer is complete. Synchronous opera- 
tions may be buffered or nonbuffered. 


D7, CB23=03 


The operating characteristics of the application program 
determine whether asynchronous buffered (A), synchronous ; 
buffered (S), or synchronous nonbuffered (N) are specified in | 
the -IN and -OUT arguments. Generally, if an application 
program is directed towards multiple terminals, specify A so 
there is full user interaction. If S or N is specified and 
someone issues a read or write, all other users have to wait. 
This is explained in more detail below. 


With asynchronous input, if an application program issues a 
read request, the system waits for previous read operations 
to complete. The data is moved to the application program, 
the read request just isSued is placed in a queue, and con- 
trol immediately returns to the application program. If the 
application program is interacting with only one terminal, 
asynchronous input is efficient, but not necessary; the 
application program can process a message while the file 
system reads the next message. Asynchronous input is neces- 
sary for an application program to interact with multiple 
terminals. For multiterminal applications, an application 
program may poll terminals and wait for input from a list of 
terminals. 


Asynchronous output permits "double buffering" output 
requests. When an application program issues a write 
request, the system waits for previous write requests to 
complete. Data 1S moved from the application program to a 
system buffer, the write request is placed in a queue, and 
control immediately returns to the application program. 


NOTE: For single-terminal applications using the roll-out 
feature, A or S provides more efficient operation. 


Example: 


STTY !VIPOl -MODES “CONTROL BYTE, STOP OUTPUT, 
AUTO CALL, HANG UP 


or 

STTY VIPO1l -MODES ~CB,~SO,AC,°~ HU 
File input/output to VIPO1 will not expect a control byte 
before each output message. Finish printing output message 
that may be in progress when a BREAK is detected. Use the 


Auto-Call unit when the file is opened. Do not hang up the 
phone when the file is closed. 
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ACTIONS FOLLOWING POWER RESUMPTION 


When the power resumption facility restarts the execution 
environment, it automatically performs a number of system func- 
tions. When the operator and system users are notified that 
power resumption has occurred, they may be required to perform 
certain actions. 


Automatic Functions 


The power reSumption facility automatically performs the 
following functions: 


e Restarts the device drivers, clock, and communications 
subsystem. 


e Reconnects peripheral devices. Reconnects terminal 
devices that were designated as being automatically 
reconnectable. 


e Resets the system date and time. (The date/time clock has 


a separate battery backup unit; it is supported through 
the real-time adapter.) 


e Reloads the memory management unit. 


e Restarts all tasks that were active when the power failure 
occurred. - 


In addition to these automatic functions, the system operator 


and system users may be required to perform certain actions. 


These power reSumption procedures are described in the Operator's 


Guide. 
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APPENDIX E 


DATA ENTRY FACILITY - I 


This appendix describes a typical configuration procedure 
that can be used to accommodate DEF-I, and lists the Linker 
directives that are required to link a DEF-I system. 


CONFIGURATION 


GCOS 6 MOD 400 software requires that the following steps be 
performed before the Data Entry Facility-I can be used: 


1. During system building, ensure that the directives 
required by the DEF-I system are included in the 
CLM USER file. 


2. Generate a DEF-I system Linker directive file that sup- 
Supports the user's CLM USER file. 


NOTE: To aid in steps 1 and 2, a sample DEF-specific 
Linker directive file (DEF SAMPLE.S) is supplied 
on the media. It may be modified to meet the 
requirements of the particular installation. 


3. Execute a Linker run to produce a DEF-I bound unit. 


4. Optionally, execute a Linker run to produce a user- 
Supplied data entry program. 


5. Generate the appropriate DEF-I system user group and 
Start-Up task command files. 


To aid in an understanding of this process, a sample DEF-I 
System configuration is used throughout this appendix. 
Configuration parameters -include: 


4 operator display stations 

1 line printer 

1 data entry program overlay area 
2 DEF-I background tasks 
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CLM-USER FILE 


After the GCOS 6 MOD 400 system has been initially loaded by 
- a stage 1 system startup, you must define a file of configuration 
directives, called the CLM _USER file, for the Configuration Load 
Manager (CLM). This file will contain the symbolic peripheral 
device names (SPD), communications arguments, and memory pool 


assignments necessary to use GCOS 6 MOD 400 software on a Level 6 
system. 


The CLM USER file directives need not be completely DEF- 
specific. That is, the devices, memory, etc., described in the 
CLM USER file may be shared by other system function facilities 


and may include specifications not required for the Data Entry 
Facility-I. 


Sample CLM-USER File 

Figure E-l illustrates a CLM USER file for a Data Entry 
Facility. The file specifies a system with four operator display 
Stations, one attached through an MDC (CONO1) and three attached 


through an MLCP/DLCP (TTX). Additionally, there are two 
diskettes and a line printer. (The bootstrap device is left 


implicit here.) 
DEVICE KSROO,0,5,X'0500' ,CONSOLE ,140 
COMM 7 
TTX 12,8,X'FFOO',0,9600 
TTX 13,9,X'FF80' ,0,9600 
DEVICE CON0O1,14,10,X'0580',CONO01,80,N,'7200',T 
TTX 15,11,X'FE80',0,9600 


PV" 16,16,X'FC00',2,00 


Figure E-1. Sample CLM _USER File 
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PVE 17,16,X'FCOO0O',2,01 
DEVICE DSKO0O0,5,14,X'0400' 


DEVICE DSKO1,6,15,X'0480' 


DEVICE LPT00,8,17,X'1380',LPTOO 


MEMPOOL S,,6000 
MEMPOOL ,AB,* 
SYS pppoe cOse OU eee 


QUIT 


Figure E-l (cont). Sample CLM _USER File 
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The following CLM USER file directives are used for a system 
that includes DEF-I. 


DEVICE DIRECTIVE 


A DEVICE directive is required for each device--except a 
communications (MLCP/DLCP-connected) operator display station-- 
used with DEF-I. (A DEVICE directive may be paired with a TTX 
directive used for a communications operator display station if 
the device is to be accessible through the file system inter- 
face.) The DEVICE directive is described in Sections 5 and 6; 
in addition, note the following points: 


e A noncommunications (MDC-connected) operator display 
Station requires the device arguments specifying non- 
buffered teletype mode of the DEF-I workstation be used 
(See Section 5). 


e If a DEVICE directive is paired with a TTX directive 
(described below), the DEVICE directive's device unit 
argument value must be TTYnn (See Section 6 to ascertain 
the device characteristics achieved by TTYnn). For 
example: ° 


DEVICE TTY00,15,11,X'FE80'‘',TTYOO, 80 


Table E-1 lists the devices configured in Figure E-1 and 
their associated device unit argument values. 
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Table E-1. Devices Configured in Figure E-1 


Device Unit 
Configured |} Argument Values 


KSROO 


Device Type 


Operator Display 
Station--MDC- 
connected TTY 


Diskette DSKOO, DSKO1L 


When more than one operator display station is configured 
for DEF-I, those CRT's must be assigned consecutive logical 
resource numbers (LRN‘'s). Similarly, all system line printers 
used by DEF-I must be asSigned consecutive LRN's. 


In Figure E-l, the four operator display stations use the 
sequential LRN‘'s 12, 13, 14, and 15. 


Also note that the number of devices configured in the 
CLM USER file may be greater than those specified when linking 
the DEF-I system (see below). Thus the DEF-I bound unit may be 
linked for three CRT's even if the CLM USER file specifies four. 


COMMUNICATIONS SYSTEM DIRECTIVE 


The COMM directive specifies that a communications subsystem 
is used. In Figure E-l1, the communications subsystem is given a 
hardware interrupt level of 7. High priority hardware levels 
Should be used for communications interrupts to ensure satisfac- 
tory operation. 


TTX DIRECTIVE 


The TTX directive specifies a TTY-type communications 
device. However, unlike the TTY directive, it provides an 80- 
character buffer. This buffer, and therefore the TTX directive, 
is required for all DEF-I operator display stations attached 
through an MLCP/DLCP. 


The TTX directive appears as follows: 
TTX lrn,level,X'channel', [modem] [,speed] 


Refer to the TTY directive in Section 6 for a description of 
the TTX arguments. 


In Figure E-l, there are three MLCP/DLCP connected operator 
display stations, and therefore three TTX directives. 
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MEMORY POOL DIRECTIVES 


A MEMPOOL directive is used to specify the system memory 
pool size. Additionally, an online user memory pool--either 
exclusive or nonexcluSive--must be specified for the DEF-I sys- 
tem. The minimum required size depends upon which DEF-I system 
functions are linked as resident and which are overlays, and upon 
the number of DEF-I workstation buffers required. Memory 
requirements are further described under "Linking a DEF-I System" 
below. The MEMPOOL directive is described in Section 5. 


In Figure E-1, the DEF-I system is configured with a single 
nonexclusive online memory pool with the name AB; this pool ex- 
tends from the end of the system memory pool to high memory. This 
Single pool can be used by the DEF-I system and by any other 
function in a group assigned to this pool, e.g., the COBOL 
compiler. 


SYSTEM DEFINITION DIRECTIVE 


The SYS (system definition) directive is described in 
Section 5. The following consideration applies to DEF-I. 


It is advisable to create several system overlay areas to 
improve the likelihood that a needed overlay is already present 
in memory (because it was recently used) and does not have to 
be reloaded. This is done through the "olan" argument of the 
SYS directive; 5 is a recommended value. 


It is also recommended that the user allocate additional 
interrupt request blocks for each DEF-I workstation. In Fig- 
ure E-l, 80 interrupt request blocks have been added for four 
workstations. This configuration supports activities in a high- 
throughput data entry environment. In amore casual data entry 
environment, approximately 10 additional interrupt request blocks 
per workstation would be adequate. 


LINKING A DEF-I SYSTEM 


The following paragraphs describe the requirements for 
linking: 


@ <A DEF-I system bound unit 
e A DEF-I data entry programs bound unit 


The Linker directives are discussed in the Program Executive and 
Checkout manual. et ge a eee 


DEF-I System Directories 


The DEF-I system object units are located in the directories 
listed in Table E-2, depending upon the system software medium. 
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Table E-2. DEF-I Object Unit 
Directory Pathname io 


Diskette “ZSYS10>ZDRT 


Cartridge Disk “ZSYS51>ZDRT 
Mass Storage Unit “ZSYS71>ZDRT 
Cartridge Module Disk “ZSYS61>ZDRT 


DEF System Object Units 


The DEF system object units are grouped in Table E-3 accord- 
ing to function. Some of these units are linked internally, and 
do not need to be specified when linking DEF-I. 


Table E-3. DEF-I Object Units 


Function Specified Not Specified 


System Object Units 


DEF-I Control ZDFLTD, ZDFCRT, ZDFINI, ZDFSTB, 
ZDFCTL ZDFDDH, ZDFBM, ZDFPH, 
ZDFIAD ZDFPRW, ZDFOLY, ZDFMSG, 
ZDFLTH, ZDFSR1, ZDFLOK, 
ZDFSRD 


Background Control ZDFBGR 


Operator Security ZDFOSR 


Operator Statistics ZDFSTA 


Function Object Units 


Applications Processor| ZDFAP 


Data Entry Processor ZDFDE 1 ZDFDE2, ZDFDE3, ZDFDE4 
Forms Processor ZDFFM1 ZDFFM2, ZDFFM3, ZDFFM4, 
ZDFFM5 


File Print Processor ZDFFP 


Tables Processor ZDFTB 


Utility Functions ZDFUT 
Supervisor Functions ZDFSP1, ZDFSP2, _ 
(ZDFPUP) en 
NY 


Verification Processor] ZDFVE 
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Additionally, dummy units listed in Table E-4 are provided 
—e so that specific DEF-I functions such as operator security, 
( operator statistics, and password updating need not be included 
in the system. | 


Table E-4. DEF-I Dummy Object Units 


Function Dummy Object Unit 


Applications ZDFAPD 
Data Entry ZDFDED 
Form Creation ZDF FMD 
File Printing ZDFFPD 
Table Creation ZDFETBD 
Utilities ZDFUTD 
Supervisor ZDFSPD 
Verification ZDF VED 
Operator Security ZDFOSD 


Operator Statistics ZDFSTD 


Password Updating ZDF PUD 


(Not required if 
Supervisor is not 
configured.) 


To create the DEF-I system bound unit, either the real unit 
or the corresponding dummy unit must be included for each 
function. For example, you must link either ZDFFP or ZDFFPD. 


Data Entry Program Object Units 


All data entry programs are optional user-Supplied programs 
that are linked into one or more bound units separate from the 
DEF-I system bound unit. Table E-5 lists the object units that 
must be linked in order to process data entry programs. These 
object units are linked with the data entry programs in a Linker 
run separate from the linking of the DEF I bound unit itself. 
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Table E-5. DEF-I Data Entry Program 
Object Units 


NE A ea SRT a) 


Memory Resident | ZDFMR 
Data Entry Program 


Director 

Data Entry Program Overlay | ZDFD1, ZDFD2, ZDFD3, ZDFD4 
Directors 

Data Entry Program Dope ZDFDVG 
Vector Generator 


Bound Unit Organization Considerations 


Before generating a DEF-I bound unit, you should consider 
the following questions: 


Which DEF-I functions are required? 

Which DEF-I functions may be overlayed? 

Is the operator security feature required? 
Is password updating required? 

Are operator statistics required? 


The available DEF-I functions are as follows: 


Applications Processing 
Data Entry Processing 
Forms Generation 

File Printing 

Table Generation 
Utility Functions 
Supervisor Functions 
Verification Processor 


If Data Entry is configured you must also consider whether 
user-Supplied data entry programs are required. 


RESIDENT AND OVERLAYED FUNCTIONS 


Each DEF-I function may be linked as memory resident or 
overlayed. Functions linked as overlays are not necessarily 
available to the display station operator at all times. Figure 
E-2 illustrates three possible DEF-I system bound unit organiza- 
tions. The first one is the bound unit as linked by DEF SAMPLE.S 
in Figure E-7. Here, only the DEF-I control function is resident 
and the remaining functions are overlays. Functions which share 
a common overtay base address cannot be used concurrently. That 
is, it would not be possible to use the data entry and forms 
functions at the same time, but it is possible to use the data 
entry and verification functions concurrently. It would not be 
possible to use the interactive and supervisor functions at the 
same time because the data entry functdon is loaded into memory 
when the verification function is selected and the data entry and 
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Supervisor functions have a common base address. Note that the 
effect of linking the application function so that it is never 
overlayed by any other function would be to leave it always in 
memory once it or any of the other functions has been used. This 
has the same effect as linking the applications function as 
memory reSident. The size of this particular DEF-I system bound 
unit would include the sum of the sizes of the DEF-I control, 
applications, data entry, and verification functions. 


The second bound unit organization in Figure E-2 allows more 
functions to be accessed concurrently. Here it would be possible 
to use the applications, file print, data entry, forms, and 
tables functions all at the same time. In this particular 
organization, the size of the bound unit is greater than the size 
of the first illustration but the difference is only by the size 
of the file print function. 


The third DEF-I bound unit organization in Figure E-2 would 
take up considerably less memory but available functions are 
limited. This organization would be Suitable once you have 
Created all necessary forms and tables for data entry and had no 
further use for those or any other functions. 


When planning the DEF-I function overlays, you must consider 
which functions are required to run concurrently in the system 
and arrange the overlays accordingly. Use of concurrent func- 
tions causes the size of the DEF-I system bound unit to increase 
according to the size of the concurrent functions. 


If a function is linked as an overlay but is not overlayed 
by any other function, it will be read into memory when first 
selected and remain in memory for the duration of the DEF-I task 
group. 


DATA ENTRY PROGRAMS 
All data entry programs are user-supplied and linked into 
one or more bound units separate from the main DEF-I system bound 


unit. 


Data entry programs can be made memory resident for speed of 
access or overlayed if sufficient memory is not available. 


The linkage procedure for user programs is described in the 


Data Entry Facility-I User's Guide. 
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RESIDENT FUNCTIONS OVERLAY AREA FOR FUNCTIONS 


| $ 

| APEND + X’'1’ 
i ! DEEND + X‘50’ 

| 

| 


LEGEND 


APPLICATIONS 

DATA ENTRY 

FORMS 

FILE PRINT 
SUPERVISOR , 
TABLES 

UTILITIES 
VERIFICATION 


<CAYTUTNODY 
ie ae ae ee | 


ocrcommmoe Ja]? [ov 


Mi! FMEND + X’'1' 
SPEND +X’1' 


(LABEL AT END OF RESIDENT FUNCTIONS) 


DEF CONTROL* 


A PS ores oy 
| (LABEL AT END OF RESIDENT FUNCTIONS) 


*Includes dummy object units for functions not available. 


Figure E-2. DEF-I Function Resident/Overlay Organizations 
MEMORY CONSIDERATIONS 
The following memory considerations must be kept in mind 


when deciding the DEF-I system bound unit organization. 
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The amount of memory required for the DEF-I system bound 
unit includes the memory required for the resident functions plus 
the memory required for all overlayed functions that can reside 
in memory Simultaneously. When all overlays start at the same 
base address, this memory size is that of the largest overlay. 


When a given function iS processing either as resident 
or aS an overlay, all operator display stations can access that 
function concurrently (the function iS reentrant). 


User-written data entry programs are linked Separately from 
the DEF-I system bound unit and have their own overlay structure. 
Up to four bound units of overlayed data entry programs are sup- 
ported. The user may link up to 99 different data entry overlay 
programs in each bound unit or overlay area. The amount of 
memory available must be large enough to contain the largest data 
entry overlay program. User-written data entry programs can also 
be linked as memory reSident. If so, they are linked into a 
Single, separate bound unit. Memory is required for the data 
entry program director plus the sum of the sizes of all user pro- 
grams up to a maximum of 20 programs. 


Additional buffer and system memory considerations are 
discussed later in this appendix. 


DEF-I System Bound Unit Creation 


Creation of the DEF-I system bound unit consists of a Linker 
run uSing a file with Linker directives that define four 
logical system categories: 


DEF-I system object units 

DEF-I memory resident DEF-I function object units 
DEF-I overlayed DEF-I function object units 

DEF-I system parameters 


Figure E-7 is a complete listing of sample Linker directives 
required by a DEF-I system. In the linking procedure described 
below, the directives in that listing are used to illustrate the 
text. 


LINKING DEF-I SYSTEM OBJECT UNITS 
Only the DEF-I system object units listed in Table E-5 must 


be linked. The remaining system object units listed in E-3 are 
internally linked and do not need to be specified. 
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Table E-6. System Object Unit Linker Directives 


Function | Linker Directives  _ | 


System Routines: LINKN ZDFCTL, ZDFBGR, ZDFLTD, ZDFIAD 
DEF-I Control and 
Background control 


Configured Not Configureco 


Operator Security LINKN ZDFOSR LINKN ZDFOSD 


Operator Statistics LINKN ZDFSTA LINKN ZDFSTD 


LINKING MEMORY RESIDENT DEF-I FUNCTION OBJECT UNITS 
If a configured DEF-I function is to be memory resident or 


if it is to be omitted from the DEF-I system, a Linker directive 
listed in Table E-7 must be used. 


Table E-7. Memory Resident Object Unit Linker Directives’ 
Applications Processor LINKN ZDFAP LINKN ZDFAPD 
Data Entry Processor LINKN ZDFDE1 LINKN ZDFDED 
Forms Processor LINKN ZDFFM1 LINKN ZDEFMD 

* File Print Processor LINKN ZDFFP LINKN ZDFFPD 
Tables Processor LINKN ZDFTB LINKN ZDFTBD 


Utility Functions LINKN ZDFUT LINKN ZDFUTD 


Supervisor Functions LINKN ZDFSP1l, LINKN ZDFSPD, ZDFPUD 
; ZDFPUP, ZDFSP2 
(See note 2) 


Verification Processor LINKN ZDFVE LINKN ZDFVED 


Notes: 1. Several of the object units listed in Tables E-3 and 
E-4 for the functions in this table do not have to 
be specified in the LINKN directives because they 
are internally linked. 


2. If the supervisor function is linked and password 


updating is not required, specify ZDFPUD in place of 
ZDFPUP. 
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LINKING DEF-I FUNCTION OVERLAY OBJECT UNITS 


( Linker directives are required to link overlayed DEF-I func- 
; tions, if any. For each function, use Linker directives to: 


Name the overlay 

Specify the base 

- Link the function object units 

- Protect the overlay base and end addresses. 


mW Nr 


Table E-8 lists the DEF-I system functions and the directives 
required to link each as an overlay. 


Table E-8. DEF-I Function Overlay Linker Directives 


Application Processor OVLY APOLAY 


BASE 

LINKN ZDFAP 

PROT APBASE,APEND 
Data Entry OVLY DEOLAY 


BASE --- 


LINKN ZDFDE1 

PROT DEBASE, DEEND 
Forms Processor OVLY FMOLAY 

BASE --- 

LINKN ZDFFM1 

PROT FMBASE,FMEND 
File Print OVLY FPOLAY 

BASE 

LINKN ZDFFP 


PROT FPBASE, FPEND 
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Table E-8 (cont). DEF-I Function Overlay Linker Directives 


ae 
Function Overlay Directives ‘ ; 


Supervisor Functions OVLY SPOLAY 


BASE 


LINKN ZDFSP1,ZDFPUP,ZDFSP2 
PROT SPBASE,SPEND 


Table Generation TBOLAY 


ZDETB 
TBBASE, TBEND 
Utility Functions OVLY UTOLAY 
BASE 
LINKN ZDFUT 


PROT UTBASE,UTEND 


Verification! OVLY VEOLAY 


BASE --- 
LINKN ZDFVE 


PROT VEBASE,VEEND 
Note: 


l. The verification function requires data entry 
processor subroutines. Therefore, its base 
Starting address must follow the last data 
entry overlay address, DEEND. 


The BASE directive must be set up according to the user re- 
quired overlay structure. Refer to the Program Execution and 
Checkout manual for a full discussion of the BASE directive. 
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If patches are applied to any DEF-I function object unit and 
the end address of that function is used as the base address for 
overlayed DEF-I functions, then the base address for that over- 
layed function should be specified as: 


[function id] END + xX'50! 


where [function id] is one of the two-character abbreviations 
Shown above. 


Each overlay has "start" and "end" labels which must be 
"PROTected' as shown. 


Figure E-7 is a sample listing of the Linker directives 
necessary to specify the DEF-I system and function object units. 


DEFINING DEF-I SYSTEM PARAMETERS 


Additional Linker directives are required to provide DEF-I 
system parameter values. The values must be placed in the half 
of a word as illustrated. 


A complete listing of the examples that illustrate the text 
is in Figure E-7. 


Specifying LRNs 


The following directives specify sample logical resource 
numbers (LRNS) required for DEF-I. Unless otherwise mentioned 
these LRNs are not related to system-wide LRNs (e.g., those in 
the CLM USER file). 


Directive Comment 
VDEF DKLRN,X'0100C! /LRN OF DISK HANDLER=1 
VDEF BMLRN,X'0200! /LRN OF BUFFER MANAGER=2 
VDEF LOKLRN,X'0300'! /LRN OF DEF FILE LOCKER=3 
VDEF INILRN,X'0500'! /LRN OF CRT1=5 
VDEF LOLRN,X'0019' /FIRST (=25) AND LAST (=X'1A'=26) LRNS 
VDEF HILRN,X'OO1A'! /FOR BACKGROUND AND OPERATIONS. 
| 2 OPERATIONS ARE ALLOWED IN THIS 
EXAMPLE. 
VDEF CRLRN1,X'0' /LRN OF MEMORY RESIDENT PROGRAM 
DIRECTOR =0 (NO MEMORY RESIDENT 
PROGRAMS ) 
VDEF OVLRN1,X'1B00'! /LRN OF DATA ENTRY PROGRAM OVERLAY 


DIRECTOR 1 =X'1B'=27 DECIMAL 
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Directive Comment 


VDEF OVLRN2,X'0' /LRN OF DATA ENTRY PROGRAM OVERLAY 
| DIRECTOR 2=0 (OVERLAY AREA NOT USED) 


VDEF OVLRN3,X'O' /LRN OF DATA ENTRY PROGRAM OVERLAY 
DIRECTOR 3=0 


VDEF OVLRN4,X'0' /LRN OF DATA ENTRY PROGRAM OVERLAY 
DIRECTOR 4=0 


Note that data entry overlay directors 2 through 4 are given 
LRNS of 0 because they are not being used. 


The LOLRN, HILRN arguments define the range of LRNs to 
execute file prints and applications in the background. In the 
example above, two LRNS are available which would allow two back- 
ground file prints, two background applications, or one of each. 


Specifying the Number of Function Overlays 


The following directive specifies the number of OVLY direc- 
tives used in linking the DEF-I functions. 


Directive Comment 
t | 


VDEF OLYNO,X'0008' /Number of function overlays = 8 
Specifying the Size of the CRT Screen | 


The following directives specify the dimensions of the 
screen of the operator display station. The forms processsor 
will not permit fields on a form to be created outside of the 
positions specified here. The size of the CRT screen must be 
Specified as follows: 


Directive Comment 
VDEF CRTC,X‘'0050' /COLS PER CRT LINE X'‘'50'=80 
DECIMAL 
VDEF CRTL,X‘'0017' /LINES PER CRT PAGE X‘'17'=23 
DECIMAL 
Specifying Continuous or Noncontinuous Keyin 


The following directive specifies whether keying is con- 
tinuous; that is, whether the system will tab forward automati- 
cally between fields or whether the RETURN key must be entered 
to reach the next field. 
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Directive Comment 


( VDEF NCONKN,X'0' /X'0' MEANS CONTINUOUS, NON X'O' 
. MEANS NONCONTINUOUS KEYIN. 


AUTCAL Argument 


This argument is required and is reserved for system use: 


VDEF AUTCAL,X'0000' / RESERVED 


CLM USER-Related Directives 


The following directives are specified in the CLM USER file. 
They define the following: 


1. The LRN of the first DEF-I CRT. The value must match 
the lowest LRN value specified in the CLM USER file for 
a device to be used aS an operator display station. 


the example, the X'0C00' corresponds to the (decimal) 
12 in Figure E-l. 


In 


Directive Comment 


VDEF CRTLRN, X'OCOO' /LRN OF FIRST CRT DRIVER = 12 DECIMAL 


_ 2. The LRN of the first printer used by DEF-I. The value 
{ must match the lowest LRN value specified in the 
. CLM USER file for a printer to be used with DEF-I. In 


the example, the X'0800' corresponds to the (decimal) 
8 in Figure E-l. 


Directive Comment 


VDEF PRTLRN, X'0800' /LRN OF FIRST PRINTER DRIVER 


The presence or absence of an operator console. A value 
of X'0059' (ASCII Y) in the VDEF OPCONS directive indi- 
cates that a console iS present; a value of X'OO4E' 
(ASCII N) indicates that there is no console. 


Directive Comment 


VDEF OPCONS, X'0059' /ASCII, Y, OPERATOR'S CONSOLE 


IS PRESENT 
4. The number of CRT's available as DEF-I operator display 
Stations. Note that this number must not exceed the 
number of CRT's specified in the CLM_USER file. 
Directive Comment 
( VDEF CRTNO, X‘'0004' /JNUMBER OF CRT'S SUPPORTED 
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5. The number of printers available to DEF-I. 


Directive 


VDEF PRTNO, 


Printer Formatting 


line and the number of lines per page for each printer. 


X'0001' 


Comment 


/NUMBER OF PRINTERS=1 


The following directives define the number of characters per 


Note 


that 16 directives must be present, even if only one printer is 


used. 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


VDEF 


PRTC1,X‘'0088' 


PRTL1,X'003E' 


PRTC2,X'0088' 
PRTL2,X'O03E' 
PRTC3,X'0088' 
PRTL3,X'OO3E' 
PRTC4,X'0088' 
PRTL4,X'O03E' 
PRTC5,X'0088 ' 
PRTL5,X'O03E' 
PRTC6,X'0088' 
PRTL6,X'O003E' 
PRTC7,X'0088' 
PRTL7,X'OO3E' 
PRTC8 ,X'0088' 


PRTL8,X'003E' 


/PRINTER 1 LINE WIDTH=136 DECIMAL 


characters (hexadecimal 88) 


/PRINTER 1 LINES/PAGE=62 DECIMAL 
(Hexadecimal 3E) 


/PRINTER 2 LINE WIDTH=136 


/PRINTER 
/PRINTER 
/PRINTER 
/PRINTER 
/PRINTER 
/PRINTER 
/PRINTER 
/PRINTER 
/PRINTER 
/PRINTER 
/PRINTER 
/PRINTER 


/PRINTER 


2 


3 


3 


LINES/PAGE=62 
LINE WIDTH=136 
LINES/PAGE=62 
LINE WIDTH=136 
LINES/PAGE=62 
LINE WIDTH=136 
LINES/PAGE=62 
LINE WIDTH=136 
LINES/PAGE=62 
LINE WIDTH=136 
LINES/PAGE=62 
LINE WIDTH=136 


LINES/PAGE=62 
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Fixed Buffer Allocation 


Each active operator display station (CRT) requires a cer- 
tain amount of workspace. For example, each active CRT requires 
a constant memory storage area of 357 words. The remaining work- 
Space requirements depend upon the function executing at the CRT 
and are provided by a set of fixed and dynamic buffers. Dynamic 
buffers are requested as they are needed from the user pool. 
Fixed buffers must be specified using Linker directives. There 
are four sizes of DEF-I fixed buffers specified using the VDEF 
directive NBl, NB2, NB3, and NB5 arguments. These buffer sizes 
are listed in Table E-9. 


Table E-9. DEF-I Fixed Buffer Sizes 


Buffer Length (Words) 
| Buffer Argument Decimal 


NBl 1024 


256 
Configurable 


10 


Buffer argument NB4 is reserved. 


Depending upon the particular application executing at the 
CRT some of the DEF-I fixed buffers are used only temporarily and 
are returned to the DEF-I fixed buffer pool as soon as their use 
is completed. The buffers may then be used by some other oper- 
ator display station, thus reducing the number of buffers that 
must be linked. 


Table E-10 shows the DEF-I fixed (F) and dynamic (D) buffer 
requirements for the DEF-I functions and indicates whether the 
buffers are temporarily held or are held as long as the function 
is being used. The figures given are for a single operator dis- 
play station. 
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Table E-10. Fixed and Dynamic Buffer Requirements 


NB1l NB2 NB 3 NB5** 
102 Wds | 256 Wds | Configurable } 
iat a 10 Was 


As many as 
needed 


Function 


AS many as 


DATA ENTRY 


DATA ENTRY WITH 


TABLES 


DATA ENTRY WITH 
PROGRAMS 


DATA ENTRY WITH 
TABLES/PROGRAMS 


needed 


As many as 
needed 


~ 
cd 


AS many as 
needed 


DATA ENTRY - 
MODIFICATION 


AS many as 
needed 


AS Many as 
needed 


DATA 
VERIFICATION 
FORMS CREATION 
FORMS MODIFY 


CREATE A VERIFY 
TABLE 

CREATE AN 
EXTRACT TABLE 
COPY A FORM 

OR TABLE 


VIEW A FORM 
OR VERIFICATION 


VIEW AN EXTRACT 
TABLE 


NO 


BEEE 
— i be 
i i | 
-— 
* 


AS many as 
needed 


PRINT A FORM 
OR TABLE 


SHIFT F7 PRINT 


mee 


_ 
+ 
~ 
| 
~ 
\ 
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Table E-10 (cont). Fixed and Dynamic Buffer Requirements 


( *Indicates that the buffers are used temporarily and then 
released. 


**¥NB5 buffers are used for extended field (program calls, 
upper/lower limits, tables, constants) used on the form. 


There is one NB5 required per extended field used on a 
form. 


General rules based upon the above table for linking NBl, 
NB2, NB3, and NB5 Size buffers are as follows: 


e For operator display stations used for data entry only 
use: 


1 NB1 per 2 operator display stations 
1 NB2 per operator display station 
1 NB3 per operator display station 


1 NB5 per operator display station per extended field on 
form 


@® For operator display stations used for development (form 
creation, tables, copies, etc.): 


2 NB1l per operator display station 
1 NB2 per operator display station 
1 NB3 per operator display station 


1 NBS per operator display station per extended field on 
form 


NOTE: Attempts to process with insufficient buffers linked 
produce unspecified results. In most cases, an 
INSUFFICIENT USER MEMORY message will appear on line 
24 of the operator display station. 


The following directives define the number of buffers allo- 
cated for each size and the size of buffer 3. Buffer 3 is used 
for the Data Entry buffer and contains the current data entry 
record. Therefore, the specified size must be the same as the 
buffer size specified when linking any data entry programs. 

Also, the number of data characters the buffer will contain is 
twice the buffer size in words less 16 characters for the header. 
(See the DEF-I User's Guide.) 
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* 


Directive Comment 


VDEF NB1,X'‘'0004' /NUMBER OF SIZE 1 BUFFERS=4 
VDEF NB2,X'0004' /NUMBER OF SIZE 2 BUFFERS=4 
VDEF NB3,X'0004' /NUMBER OF SIZE 3 BUFFERS=4 
VDEF NB4,X'0000'° /NUMBER OF SIZE 4 BUFFERS=0 
VDEF NB5,X'0028' /NUMBER OF SIZE 5 BUFFERS=40 


(hexadecimal 28) 


VDEF SB3,X'0080' /SIZE OF BUFFER3 = 128 (Hex 80) 
words=256 characters 


Data Entry Program General Purpose Buffer 


The following directive specifies the size of the general 
purpose buffer, buffer number 6, used by any data entry program. 
You must specify a buffer size as large as the largest general 
purpose buffer required by any data entry program that will 
execute on your system. The buffer size is specified in words, 
half the number of characters the buffer will hold. One buffer 
1S used for each operator display station executing a data entry 
program. 


Directive Comment 
VDEF DUPWRD,X‘'0020' /SIZE OF DATA ENTRY PROGRAM 


GENERAL PURPOSE BUFFER=32 
/(hex 20) WORDS = 64 
/ CHARACTERS 


First LEN 


The following directive defines the first LFN to be used 
by DEF-I. This number affects the value of the maximum LFN 
argument specified in the spawn group command for the task 
group. In the following example, LFNs 1 to 8 are available for 
use by data entry programs. Note, however, that the DEF-I LFNs 
may also start at 1. In that case, the program LFNS would start 
following the last DEF-I LFN. DEF-I requires 8 LFNsS per operator 
display station and 8 LFNS per background area. 


VDEF CRTLFN,X‘'0009' /FIRST CRT LEN=9 


Number of Background Tasks 
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The following directive defines the number of background 
tasks to be run concurrently. It cannot exceed the number of 
CRT'sS nor can it exceed the total number of LRNs defined by the 
LOLRN and HILRN arguments. File printing and application pro- 
grams optionally run in the background. File print needs a back- 
ground task even when the print operation is not in the back- 
ground. At least one background task must be specified. 


VDEF BAKNO,X‘'0002' /NUMBER OF BACKGROUND TASKS=2 


Assigning Volume Name 


Each of the following four directives defines two characters 
of the name of the volume which DEF-I will initially use for 
forms, tables, and data entry. The hexadecimal values for the 
appropriate ASCII characters are specified. Only eight char- 
acters are allowed, the first must be circumflex (hexadecimal 
5E), the eighth must be hexadecimal 3E. Note that the volume as- 
Signments can be changed by a DEF-I supervisory function, but 
this link specified volume name must be present when DEF-I is 
loaded. 


Directive Comment 
VDEF SVN1,X'5E44' /SYSTEM VOLUME= “D 
VDEF SVN2,X'4546' / =EF 
VDEF SVN3,X'5752' J =WR 
VDEF SVN4,X'4B3E' / =K> 


Specifying Password Parameters 


The following directives define the size and total number of 
passwords available and one initial password used to gain entry 
to DEF-I. Note that the initial password is specified using five 
directives, one for each two characters, even if the password is 
less than 10 characters long. The excess characters must be 
specified as blanks (hex 20). The directives are only required 
if the operator security feature is linked. The passwords may be 
maintained by the password update facility. 
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Directive Comment 


oe 
VDEF PASSNO,X'0010' /NUMBER OF PASSWORD AVAILABLE=16 : | 
(hex 10) ~~ 
/MUST BE O IF NO OPERATOR SECURITY 
VDEF PASSIZ,X'0004' /LENGTH OF PASSWORD=4. MAXIMUM 
/SIZE IS 10 CHARACTERS 
VDEF PASS1,X'4445' /INITIAL PASSWORD IS DEF3.2 
VDEF PASS2,X'4633' /(HEX 44, 45, 46, 33, 2E, 32= ASCII 
DEF 3.2) 
VEDF PASS3,X'2E32' (HEX 2E,32=ASCII.2) 
VDEF PASS4,X'2020' /(HEX 20=BLANK) 
VDEF PASS5,X'2020' 
Specifying Password Accessible Functions 
The following directive specifies the functions which may be 
accessed uSing the first password specified above. If any addi- 
tional passwords are required the initial password must be given 
access to the supervisor function. The functions available are ; 
Specified by the first 9 bits of the 16 bit, 4 hex character ee 
argument. If the bit value for the associated function is zero, 
the function is not available; if the bit value is one, the 
function is available. Table E-1l1 lists the bits and their asso- 
ciated functions. Bit 0 is the high order bit. 
Table E-ll. Accessible Function Specification 
0 Applications 
1 Data Entry 
2 Forms 
3 File Print 
4 (Reserved) 
5 Supervisor 
6 Tables 
7 Utilities 
8 Verification 
Thus, a directive specifying that all functions are avail- 
able using the first password would be as follows. This direc- 
tive content is recommended. 
a 
Nw YF 
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Comment 


Fe RE eS EE Bet 


Directive 


VDEF PASSFN,X'FFFF' /ALL FUNCTIONS ARE AVAILABLE 


Specifying Allowable Operator Functions 


The following directives determine which DEF-I functions can 
be selected by the operator display station users. If X'0000' is 
entered for any of these directives, the corresponding DEF-I 
function cannot be used by any data entry operator. If the 
function is to be allowed, the hexadecimal value of the appro- 
priate ASCII character must be specified, as illustrated in the 
example. 


Directive Comment 


/ALLOW APPLICATIONS=A 
/ALLOW DATA ENTRY=D 

/ALLOW FORM CREATE=F 

/ RESERVED 

/ALLOW FILE PRINT=P 

/ALLOW SUPERVISOR FUNCTION=S 
/ALLOW TABLES CREATE=T 
/ALLOW UTILITIES=U 

/ALLOW VERIFICATION=V 


VDEF APPL,X'0041' 
VDEF DATA,X'0044' 
VDEF FORM,X'0046' 
VDEF INTRA,X'0000! 
VDEF FILPRN,X‘'0050! 
VDEF SUPER,X'0053! 
VDEF TABLE,X'0054! 
VDEF UTIL,X'0055'! 
VDEF VERIF,X'0056'! 


Printer AsSignments 


The following directives determine the initial printer 
assignments for each CRT. All 20 assignments must be made, even 
though fewer than 20 CRT'sS are available. Printer assignments 
may be temporarily changed by a DEF-I Supervisory Function. 


Directive Comment 
VDEF PCRT1,X'OOO1' /CRT 1 USES PRINTER 1 
VDEF PCRT2,X'OOO1' /CRT 2 USES PRINTER 1 
VDEF PCRT3,X‘'OO01' /CRT 3 USES PRINTER 1 
VDEF PCRT4,X'OOO1' /JCRT 4 USES PRINTER 1 
VDEF PCRT5,X'O00O1' /CRT 5 USES PRINTER 1 
VDEF PCRT6,X‘'OOO1' /CRT 6 USES PRINTER 1 
VDEF PCRT7,X'OOOL1' /CRT 7 USES PRINTER 1 
VDEF PCRT8,X'OOO1' /ZCRT 8 USES PRINTER 1 
VDEF PCRT9,X‘'0001' /CRT 9 USES PRINTER 1 
VDEF PCRT10,X'OOO1' /CRT 10 USES PRINTER 1 
VDEF PCRT11,X‘OOOI1' /CRT 11 USES PRINTER 1 
VDEF PCRT12,X'OOO1' /CRT 12 USES PRINTER 1 
VDEF PCRT13,X'‘OOOL1' /CRT 13 USES PRINTER 1 
VDEF PCRT14,X'OOO1' /CRT 14 USES PRINTER 1 
VDEF PCRT15,X'OOOL1' /CRT 15 USES PRINTER 1 
VDEF PCRT16,X'0O0O0O1' /CRT i6 USES PRINTER 1 
VDEF PCRT17,X'OOOL' /CRT 17 USES PRINTER 1 
VDEF PCRT18,X'OOO1' /CRT 18 USES PRINTER 1 
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Directive Comment 


VDEF PCRT19,X'0001' 
VDEF PCRT20,X'0001' 


/CRT 19 USES PRINTER 1 
/CRT 20 USES PRINTER 1 


Data Entry Overlay Areas 


The following directives define which of the data entry 
overlay areas iS to be used by each operator display station for 
execution of overlayed data entry programs. The hexadecimal 
value is the number of the data entry overlay area to be used 
and must be in the range 0001 through 0004. 


As with the printer assignments, the data entry overlay 
area aSSignments must be made for 20 CRT's, even though fewer are 
available. Note that these overlays are different from the DEF-I 
function overlay area. 


Directive Comment 
VDEF OCRT1,X'0O001' /CRT 1 USES OVERLAY 1 
VDEF OCRT2,X'OOO1' /CRT 2 USES OVERLAY 1 
VDEF OCRT3,X‘0001' /CRT 3 USES OVERLAY 1 
VDEF OCRT4,X'OOOL1' /CRT 4 USES OVERLAY 1 
VDEF OCRT5,X'0001' /CRT 5 USES OVERLAY 1 
VDEF OCRT6,X'‘'O001' /CRT 6 USES OVERLAY 1 
VDEF OCRT7,X‘'0O001'! /CRT 7 USES OVERLAY 1 
VDEF OCRT8,X‘0001' /CRT 8 USES OVERLAY 1 
VDEF OCRT9,X'‘'0001' /CRT 9 USES OVERLAY 1 
VDEF OCRT10,X‘'0001' /CRT 10 USES OVERLAY 1 
VDEF OCRT11,X‘0001' /CRT 11 USES OVERLAY 1 
VDEF OCRT12,xX‘'0O001' /CRT 12 USES OVERLAY 1 
VDEF OCRT13,X‘'0O001' /CRT 13 USES OVERLAY 1 
VDEF OCRT14,X‘0001' /CRT 14 USES OVERLAY 1 
VDEF OCRT15,X'0001' /CRT 15 USES OVERLAY 1 
VDEF OCRT16,X'‘'0001' /CRT 16 USES OVERLAY 1 
VDEF OCRT17,X'0O0OO0O1' /CRT 17 USES OVERLAY 1 
VDEF OCRT18,xX‘0001' /CRT 18 USES OVERLAY 1 
VDEF OCRT19,X‘'0001' /CRT 19 USES OVERLAY 1 
VDEF OCRT20,X‘'0001' /CRT 20 USES OVERLAY 1 


Completing the Link 


GROUP GENERATION FOR A DEF-1 SYSTEM 


The link must 
S 


30 
io 


P 


| 


1 
i 


be completed with the 


QUIT directive. 


The 


Use the SG (Spawn group) command to spawn a task group in 
which DEF-I can operate. 


A complete description of the SG com- 
mand appears in the Commands manual. 
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Task Group Considerations 


The task group in which DEF-I is to execute requires the 
following specifications for the maximum LRN and LFN: 


LRN - the value must be greater than the maximum LRN used in 
the START UP.EC file's CT (create task) commands. 


LFN - the value must be equal to or greater than the result 
of the following algorithm: 


base LFN specified in the Linker VDEF CRTLFN directive 
+ 8 x (number of CRT'sS) 
+ 8 x (number of background tasks allowed at one time) 
+ 1 if operator statistics are required 


+ the number of LFNs required by data entry programs and 
applications. 


Example of a Spawn Group Command 


For example, a typical DEF-I SG (Spawn group) command might 
be as follows: 


SG AA D.E.F. 0 !CONSOLE ~LRN 28 ~LFN 58 -POOL AB -WD DEFDIR 
9G 


The spawn group command 


AA 
The id assigned to this task group 

D.E.F. 
The user id assigned 

0 
Relative priority level for this task group's lead 
task 

!' CONSOLE 

Input path for commands and user input 

-LRN 28 


Highest logical reSource number that will be referred 
to by any task in the task group 
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-LFN 58 


Highest logical file number used by any task in the 
Spawned task group 


-POOL AB 


Name of the memory pool from which all dynamic memory 
required by the task group is to be taken 


-WD DEFDIR 
The working directory to be used by the task group. 
The directory used should have a START_UP.EC file 
containing the CT (create task) command to activate 
DEF-I. 


The LRN in the example is greater than the maximum LRN used 
in the START UP.EC file's CT (create task) command below. 


The LFN value of 58 is greater than the value determined by 
the following calculation: 


LFN = 8x4 (terminals) + 8x2 (background tasks) + 9 (base 
LFN, specified in Linker VDEF CRTLFN directive) = 5/7 


DEF START-UP.EC FILE (TASK GENERATION) 

Once the SG (Spawn group) command has been executed, several 
DEF-I tasks must be created and activated. Appropriate CT (cre- 
ate task) commands may be stored in a START _UP.EC file immedt- 
ately subordinate to the inital workng directory of the spawned 


task group or they may be specified individually at initializa- 
tion time. START UP.EC files are discussed in the System 


Concepts manual. 


Create Task 
Tasks are created by CT (create task) commands as follows: 
CT lrn rel level ctl_arg 


lrn is the logical resource number by which the task 
group refers to the task 


rel level is the priority level of the task 
ctl _arg is either the control argument 
-EFN root?symbolic-start-—address 
or 


-~SHARE lrn symbolic-start-address 
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where the -EFN argument includes the name of the 
Om « bound unit root segment (here DEF-I) followed by 
( a question mark, followed by the symbolic-start- 
address (entry point) within the root segment, 
DEF initialization (INFNTR). 


The -SHARE control arguments specify the addi- 
tional entry points within the DEF bound unit, 
and the LRN used is that associated with the 
initialization (INFNTR) entry point. 

RELATIVE LEVEL REQUIREMENTS 


The CT (create task) command priority level requirements for 
DEF-I tasks are Shown in Table E-12. 


Table E-12. DEF-I Relative Priority Level Requirements 


Relative 
Level Symbolic-Start-Address Description 
DSHTAS DEF Disk Handler 
DBENT DEF Buffer Manager 
LOCKO1 DEF File Lock Routine 
INFNTR DEF Initialization/CRT #1 
Control 
CENTRY DEF CRT #2 (and up) Control 
(none) DEF Background Functions 
COBMR1 if memory resident | Optional for Data Entry 
COBOV1 is overlay area 1] Programs 


COBOV2 is overlay area 


2 
COBOV3 is overlay area 3 
COBOV4 is overlay area 4 


In this example CENTRY, background tasks, and data entry 
programs are not given relative level values because one CT 
(create task) command is required per CRT, background task, and 
bound unit for data entry programs. Note that a maximum of four 
overlay areas and one memory resident bound unit for data entry 
programs may be specified. Note also that these are minimum 
relative level requirements within DEF-I and do not reflect any 
other LRNS within the task group. 


~ 1n - Last relative level used for a CRT 
| m — Number of background tasks created. 
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Sample START_UP.EC File 


The commands listed in Figure E-3 are typical for a DEF-I 


START UP.EC file. 


CWD >DEFODIR 


CT 
CT 
CT 
CT 
CT 
CT 
Cr 
CT 
cr 
CT 


RDN 


awyownrn oN 
rm~ OHO ty wO— WM 


25 
26 
al 


EER 


&N 


Figure E-3. 
In this example, 


e 4 CRT's 


@e 2 background (file print/application) 


~EFN DE 


—SHA Re 
-SHARc 
—SHA Re 
-—SHA Re 
- SHARc 
~SHARE 


F 4 
2. 
2 


5 
5 


INFNTR 
DSHTAS 
UD bBENT 

LOCKO] 
CENTRY 
CENTRY 
CENT RY 


25 -SHARE 5 
26 -SHAKE 5 


27 -ERN ENTRYI?7COBOVI 


DEF-I has the following: 


The filename is ~ZSYS71>DEFDIR>START UP.EC. 


Sample DEF-I START UP.EC File 


tasks. 


e 1 data entry program overlay area named ENTRY1 


The name of the DEF-I bound unit is DEF. 


SAMPLE SYSTEM FILE STRUCTURE 


Figure E-4 illustrates the path structure of the DEF-I 


related system files, 


as they are Supplied on the release media 


(the directory root name “ZSYS71 indicates a mass storage unit). 


Included are the sample CLM USER file, CLM SAMPLE, 


the sample 


DEF-I linker directive file DEF SAMPLE.S, IEF SAMPLE.S, and all 
DEF-I required object units. 


Figure E-5 illustrates a typical path structure of DEF-I 


related system files once 
following files have been 


e The CLM USER file 
This is placed in 


the DEF-I system has been built. 


The 


added to those shown in Figure E-4, 


(for example, 
the directory SID. 


the file in Figure E-l). 


e The DEF-I spawn group command contained in an EC file. 


The file is illustrated in Figure E-6. 


directly under the system root. 


Note that this is 


e The DEF-I linker directives used to create the bound unit 
called DEF USER.S. 


ZDRT. 


This file is under the 


e The DEF-I bound unit called DEF. 


directory 
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Nine an nel 


| e The START _UP.EC that creates the DEF-I tasks is in the 
DEFDIR directory. An example of the startup file is 
( illustrated in Figure E-3. 


e The bound units for the DEF-I data entry programs. 

The user-created DEF-I and data entry program bound units 
and the user-created DEF START _UP.EC are in a user-created direc-— 
tory DEFDIR. 


Note that this set of files, naming conventions, and file 
paths is used as an illustration only. 


“ZSYS71 
SID ZDRT | 
ie aie — ZDFCTL.O 
@ @ 
. i DEF OBJECT 
7 UNITS 
' @ @ 
ZDFVED.O 
ZDFDVG.O 
ZDFMR.O 
ZDFD1.0 | OBJECT UNITS 
FOR DATA ENTRY 
ZDFD2.0 | proGRAMS 
ZDFD3.0 
ZDFD4.0 
DEF_SAMPLE.S 
* 
( Figure E-4. Paths of System Files 
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™ZSYS71 


SID ZDRT DEF.ECd 
ie | zpFcTL.o 
° . DEF OBJECT 
CLM_USER? © 6 UNITS 
e e 
ZDFVED.O 
ZDFDVG.O 
ZDFMR.O 
OBJECT UNITS 
ZDFD1.0 FOR DATA 
ZDFD2.0 ENTRY 
PROGRAMS 
ZDFD3.0 
ZDFD4.0 
DEF_SAMPLE.S 
* DEF_USER.S? 


“User-created CLM 

User-created LINKER directives for DEF bound unit 

“DEF bound unit 

dec file that spawns DEF group in working directory DEFDIR 
“START—UP.EC file that creates DEF tasks and issues group ready-on message 
fUser—created data entry program (see the Data Entry Facility User’s Guide.) 


DEFDIR 
START _UP.EC® 


DEFS 


ENTRY 1! eee 


BOUND UNIT 
FOR DATA 
ENTRY 
PROGRAMS 


Figure E-5. Sample Disk Organization of System and 


User DEF-I Files 
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Figure E-6 
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Sample DEF-I SPAWN GROUP EC File 


> ce 
'y 


Pobre 
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Operator Startup Actions 


After all the preparatory procedures described in this 
section are completed and checked out, a DEF-I system can be 
started up by following a two-step procedure. Before presenting 
the procedure, the files that are required to be on disk are 
described: 


A CLM_USER file specific to DEF-I under the directory SID 


Bound units for the DEF-I system and user data entry 
programs. In the sample disk organization in Figure E-5, 
they are named DEF and ENTRYI. 


A START UP.EC file in the working directory to create 
DEF-I tasks and start executing at the proper entry 
point. In Figure E-5, the file START UP.EC is in sample 
working directory DEFDIR. - 


An EC file to spawn a group for DEF-I, for example, 
DEF.EC in Figure E-5. 


The operator actions are then: 


i 


Ze 


Bootstrap the system software 


Enter the following command at the operator terminal: 
EC DEF 


A task group is created and the command processor 
loaded. The START UP.EC files are then executed. They 
create and load the tasks of the DEF-I system, and then 
Start execution of the initial DEF-I task, DEF?INFNTR, 
in the sample START _UP.EC file in Figure E-3. 


SAMPLE LINKER DIRECTIVE FILES 


Figure E-7 is a listing with supplied sample argument 
values, of all the Linker directives required to link a DEF-I 


system. 
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/ LINKER COMMANDS FOR DEF 3.2 (FOR NON-RESIDENT SYSTEM) 
LIB >ZORT 


LINKN 
LINKN 
LINKN 
LINKN 
LINKN 
LINKN 
/ 
OVLY 
BASE 


ZDFCTL 
ZOFIAD 
ZDFLTD 
ZDFOSR 
ZDOFBGR 
ZOFSTA 


APOLAY 
$ 


LINKN ZDFAP 


PROT 
OVLY 
BASE 


APBASE,APEND 
DEQLAY 
APEND+X°1° 


LINKN ZOFDE1 


PROT 
OVLY 
BASE 


DEBASE,DEEND 
FMOLAY 
APEND+X“°1” 


LINKN ZDFFM1 


PROT 
OVLY 
BASE 


FMBASE ,FMEND 
FPOLAY 
APEND+X°1° 


LINKN ZOFFP 


PROT 
OVLY 
BASE 


LINKN ZOFSP1,ZD0FPUP,ZDF SP 


PROT 
OVLY 
BASE 


FPBASE,FPEND 
SPOLAY 
APEND+4X°1° 


SPBASE, SPEND 
TBOLAY 
APEND4X°1° 


LINKN ZOFTB 


PROT 
OVLY 
BASE 


TBBASE, TBEND 
UTOLAY 
APEND+#+X°17 


LINKN ZOFUT 


PROT 
OVLY 
BASE 


UTBASE,UTEND 
VEOLAY 
DEEND+X°50” 


LINKN ZDFVE 


PROT 


VEBASE, VEEND 


NNN RN RNR NR NNN RR RRR RR RRR RRR RRR RRR NS 


LIBRARY OF OBJECT MODULES 

DEF SYSTEM ROUTINES 

REQUIRED FOR DEF SYSTEM 

REQUIRED FOR DEF SYSTEM 

OPERATOR SECURITY 

BACKGROUND CONTROL 

OPERATOR STATISTICS 

DEF FUNCTION OVERLAYS 
APPLICATIONS OVERLAY 

STARTS AFTER END OF ROOT 

LINK APPLICATIONS 

PROTECT START/END ADDRESS 
OVERLAY DATA ENTRY 

START AFTER ENO OF APPLICATIONS 

LINK DATA ENTRY 

PROTECT START/END ADDRESS 

FORMS PROCESSOR OVERLAY 

STARTS AFTER END OF APPLICATIONS 

LINK FORMS PROCESSOR 

PROTECT START/END ADDRESS 

FILE PRINT PROCESSOR OVERLAY 

STARTS AFTER END OF APPLICATIONS 

LINK FILE PRINT PROCESSOR 

PROTECT START/END ADDRESS 

SUPERVISOR FUNCTIONS OVERLAY 

STARTS AFTER END OF APPLICATIONS 
/ LINK SUPERVISOR/PWRD UPDATE 

PROTECT START/END ADDRESS 

TABLES PROCESSOR OVERLAY 

STARTS AFTER END OF APPLICATIONS 

LINK TABLES PROCESSOR 

PROTECT START/END ADDRESS 

UTILITIES PROCESSOR OVERLAY 

STARTS AFTER END OF APPLICATIONS 

LINK UTILITIES PROCESSOR 

PROTECT START/END ADDRESS 

VERIFICATION PROCESSOR OVERLAY 

STARTS AFTER DATA ENTRY 

LINK VERIFICATION PROCESSOR 

PROTECT START/END ADDRESS 


ieee te et ee eee eee eeeeeceeese cece rcee cece eeceeeeeeerecCeeSeCeeeeee ee & | 


/ / DEF SYSTEM LRNS 
VOEF DKLRN,X°01007 / LRN OF DISK HANDLER 
VDEF BMLRN,X°02007 / LRN OF BUFFER MANAGER 
VDEF LOKLRN,X°0300”% / LRN OF FILE LOCKER 
VDEF INILRN,X°05007 / LRN OF CRT 1 CINITIALIZATION LEVEL) 
VDEF LOLRN,X°00197 / LOW LRN AVAIL FOR IEF /BACKGROUND 
VDEF HILRN,X°001A% / HIGH LRN AVAIL FOR IEF/BACKGROUND 
VDEF CRLRN1,X°00007 / LRN OF DLE. MEM. RESIDENT PROGRAM DIRECTOR 
VOEF OVLRN1,X°1800" / LRN OF D.E. OVERLAY DIRECTUR 1 
VDEF OVLRN2-X°0000°% / LRN OF OLE. OVERLAY DIRECTOR 2 
VDEF OVLRN3,X°0000" / LRN OF DLE. OVERLAY DIRECTOR 3 
VOEF OVLRN4,X°0000" / LRN OF DLE. OVERLAY DIRECTOR 4 
/ 
VDEF OLYNO,X°8” / NUMBER OF FUNCTIONS Uv uc AYEC 

( Figure E-7. Sample DEF-I Linker Directive File 
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CRTC,X’°0050% / COLS PER CRT LINE | | | 
CRIL,X°0017°% / LINES PER CRT PAGE oe 
NCONKN,X°0? / Q = CONTINUOUS, NON 0 = NON CONTINUOUS KEY IN 
AUTCAL,X70000° / RESERVED | 

/ REFERENCES TO LRN’S IN CLM_USER 
CRTLRN,X°0C00° / LRN OF CRT 1° DRIVER 
PRTLRN,X°0800°% / LRN .OF PRINTER 1 DRIVER 
OPCONS,X°59° 4/59 = OP. CONSOLE, 4E = NO OP. CONSOLE 
CRTNO,X°0004” 4 TOTAL NUMBER OF CRTS 
PRTNO,X°00017 / NUMBER OF PRINTERS CONFIGURED 

/ PARAMETERS TO DEFINE PRINTERS 
‘PRTC1,X°0088° / PRINTER 1 LINE WIDTH 
PRTL1,X°003E”’ / PRINTER 1 LINES PER PAGE 
PRTC2,X°0088” / PRINTER e LINE WIDTH 
PRTL2sX°003E” / PRINTER 2 LINES PER PAGE 
PRTC3,X°0088’ / PRINTER 3 LINE WIDTH 
PRTL3,X°O0Q03E’ / PRINTER 3 LINES PER PAGE 
PRTC4,X°0088”’ / PRINTER 4 LINE WIDTH 
PRTL4Y,X°O00S5E”’ / PRINTER 4 LINES PER PAGE 
PRTC5,X°0088” / PRINTER 5 LINE WIDTH 
PRTL5,X°003E° / PRINTER S LINES PER PAGE 
PRTC6/X°0088” / PRINTER 6 LINE WIDTH 
PRTL6,X°003E”’ / PRINTER 6 LINES PER PAGE 
PRTC7,X°0088’ / PRINTER 7 LINE WIDTH 
PRTIL7,X°003E” / PRINTER 7 LINES PER PAGE 
PRTC8,X°0088” / PRINTER 8 LINE WIOTH 
PRTL8,X°0035E” / PRINTER 8 LINES PER PAGE 

/ BUFFER ALLOCATIONS 
NB1,X°0004’ / NO. OF SIZE 1 BUFFERS 
NB2,X*°0004” / NO. OF SIZE e BUFFERS 
$B3,X°0080’ / SIZE OF DATA ENTRY BUFFER 
NB3,X°0004" / NO. OF SIZE 3 BUFFERS 
NB4,X°0000° / NO. OF SIZE 4 BUFFERS 
NB5,X°0028’ / NO. OF SIZE 5S BUFFERS 
DUPWRD,X°0020’ / SIZE OF GENERAL PURPUSE BUFFER 
CRTLFN,X°0009” / FIRST LFN AVAILABLE TO DEF 
BAKNO,X°0002°. / NUMBER OF BACKGRUUND TASKS 

/ DEF SYSTEM VOLUME NAME 
SVN1,X°SE44” / SYSTEM VOLUME IS i= “*D0 
SVN2,X"°4546% / , EF 
SVN3,X°5S752° / WR 
SVNG,X°4B3E ° / K> 

/ PARAMETERS TO DEFINE SYSTEM PASSWORDS 
PASSNO,X’°0010° / NO. OF PASSWORDS (=0 IF NO OPERATOR SECURITY) 
PASSIZ,X°0006° / LENGTH OF PASSWORD 
PASS1,X°4445° / INITIAL PASSWORD = DEF3.2 
PASS2,X° 4633’ | 

F. PASS3,xX%° 2E32’ 
PASS4,X’2020° 
PASS95,X%2020° | | | 7 : 
PASSFN,X°FFFF °% / FUNCTIONS FOR INITIAL PASSWORD | 
| | BIT 0 = AP, BIT 1 = DE, BIT 2 = FM, 
BIT 3 = FP, BIT 4 = (RESERVED), SIT 5 = SP, 
BIT 6 = TB, BIT 7 = UT, BIT 8 = VE 


/ FUNCTION LIST €O = NOT CONFIGURED) 


Figure E-7 (cont). Sample DEF-I Linker Directive File 
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APPL,X°41° 
DATA, X°44”% 
FORM,X° 46” 
INTRA,X°00° 
FILPRN,X°50°% 
SUPER,X°53° 
TABLE, X°S4” 
UTIL,X°55” 
VERIF,X°56” 


PCRT1,X°0001° 
PCRT2,X°0001’ 
PCRT3,X°0001’ 
PCRT4,X°%0001’ 
PCRT5/X°0001° 
PCRT6yX°0001° 
PCRT7,X°00017 
PCRT8,X°0001° 
PCRT9,X"0001’ 
PCRT10,X°0001° 
PCRT11,X°0001° 
PCRT12,X%°0001" 
PCRT13,X°0001° 
PCRT14,X°0001° 
PCRT15,X°0001" 
PCRT16,X°0001° 
PCRT17,X°0001" 
PCRT18,X°0001" 
PCRT19,X°0001”" 
PCRT20,X°0001° 


OCRT1,X%°0001° 
OCRT2,xX°0001° 
OCRT3,X°0001’ 
OCRT4,X°0001" 
OCRTS,X“%0001”" 
OCRT6,X°00017 
OCRT7,X°0001° 
OCRT8,X°0001% 
OCRT9,X°0001° 
OCRT10,X°0001" 
OCRT11,X°0001° 
OCRT12,X°0001° 
UCRT13,X°0001° 
OCRT14,X°0001" 
OCRT15,X°0001” 
OCRT16,X°0001" 
OCRT17-X°0001” 
OCRT18,X°0001° 
OCRT19,X°0001° 
OCRT20,X°0001"% 


Figure E-7 
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(cont). 


APPLICATIONS 
DATA ENTRY © 
FORM CREATION 


RESERVED 


FILE PRINT 
SUPERVISOR 


TABLES 


UTILITIES 
VERIFICATION 


PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
PRINTER 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 
OVERLAY 


ASSIGNMENTS FOR EACH CRT 


ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 
ASSIGNMENT 


DIRECTOR ASSIGNMENT PER CRT 
AREA FOR CRT 
AREA FOR CRT 
AREA FOR CRT 
AREA FOR CRT 
AREA FOR CRT 
AREA FOR CRT 
AREA FOR CRT 
AREA FOR CRT 
AREA FOR CRT 


FOR 


FOR 


OOnN CU EWN 


AREA FOR CRT 10 
AREA FOR CRT 11 
AREA FOR CrT le 
AREA FOR CRT 13 
AREA FOR CRT 14 
AREA FOR CRT 15 
AREA FOR CRT 16 
AREA FOR CRT 17 
AREA FOR CRT 18 
AREA FOR CRT 19 
AREA FOR CRT 20 


CRT 


Sample DEF-I Linker Directive File 
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APPENDIX F 


REMOTE BATCH FACILITY/66 


CONFIGURATION 


After the GCOS 6 MOD 400 software has been initially loaded 
by a stage 1 system startup, you must define a file of input 
directives, called the CLM USER file, for the Configuration Load 
Manager (CLM). This file will contain the device symbolic names, 
communications arguments, and memory pool assignments necessary 
to use GCOS 6 MOD 400 software on your hardware system. 


Any future changes to the Remote Batch Facility configura- 


tion are made by editing the CLM USER directive file to reflect 
these changes. 


c 
q Configuration Directives 
To create a Remote Batch Facility with Remote Computer 
Interface (RCI), you must specialize your GCOS 6 MOD 400 system 
software by providing the necessary configuration directives. rm 
NOTE: Only information specifically required to create 
an RCI Remote Batch Facility is provided. Full * 
descriptions of configuration directives are given 
in previous sections of this manual. 
DIRECTIVES APPLICABLE TO RCI ‘ 
SYS 60,100,,10,tsSa,irb 
The olan argument must be >2. 
Suggested values for tsa: 
30 for RCI 
Suggested values for irb: | * 
( 60 for RCI 
| + 


Bei CB23-03 


COMM 8 


This directive is used in the normal manner; i.e., it a: 
must precede the LPHn directives and specify the com- © . 
munications interrupt level. Both the communications 
interrupt level and the normal mode level should be 


the highest priority hardware levels in the system to 
ensure satisfactory operation. 


Recommended levels are 7 or 8 in the COMM directive 


and 8 or 9 in the second argument of all LPHn direc- 
tives (see below). 


ACU Irn,level,X'acu_channel'[,'phone #1][,'phone #2'][,...] 


This directive is used in the normal manner to con- 


figure the optional Auto Call Unit for automatic 
dialing. See Section 6. 


MEMPOOL S,,Size 


The Remote Batch Facility requires a system memory 
pool size of 9200 words. 


For example, if your configuration requires 5500 
words for system functions and 9200 words for the 
Remote Batch Facility, you would specify: 


MEMPOOL S,,14700 
LDBU ZERRST 


You must include this directive in your CLM file if you wish 
to collect peripheral device or memory error Statistics. 
Error logging configuration is fully described elsewhere in 


this manual. Error logging procedures are described in the 
Operator's Guide. 
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Example of Remote Batch Configuration Directives 


The following directives give configuration information for 
a Remote Batch Facility having four RCI streams. 


MEMPOOL S,,16000 

MEMPOOL ,AB,* 

COMM 8 

RCI 32,10,X'FCOO' 

DEVICE RCIO00,32,10,X'FCO0',LINE32 
RCI 33,10,X'FC80" 

DEVICE RCIO01,33,10,X'FC80' ,LINE33 
LDBU ZERRST 


QUIT 


NOTE: The bound unit ZQRCI must reside in directory SID 
of the root directory. The LDBU ZERRST directive 
allows the uSer to configure error logging, as 
described in Appendix P. Using this CLM file, the 
user may designate his host link by one of the 
following: RBT 32 

RBT !LINE32 
RBT >SPD>LINE32 


INITIALIZATION 


Once configuration is complete, you can execute an RBT in 
the task group $H or create your own task group. If multiple 
terminals are used, there must be a task group for each terminal. 
The different methods that can be used to create a task group 
are described below. Whether you use $H or create your own 
group, you must also assign devices/files, modify external 
Switches if necessary,. and invoke the task group. 


Using the SH Task Group 
To use the Honeywell-supplied $H task group, enter: 
EC GROUPSH (C/R) 


The command file creates the task group. 
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Initializing with the Spawn Group Command 
Use the spawn group (SG) command to create your own task 
group in which the remote batch terminal can operate. A complete 


description of the SG command can be found in the Commands 
manual. 


The following is an example of the SG command used to create 
an RBT task group: 


SG Al SMITH.RBT.OPR 2 !CONSOLE -OUT !CONSOLE -POOL AB 
-WD RBT DIR -LRN 2 


SG 
The spawn group command. 
Al 


The id assigned to this task group. 
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SMITH.RBT.OPR 


The user id assigned 


2 
Relative priority level for this task group; each RBT 
task group you Spawn must be assigned a unique 
priority level. 

!CONSOLE 


Input path for commands and user input. 


-OUT !CONSOLE 


File that is to receive user output and error output. 


-~POOL AB 


Name of the memory pool from which all dynamic memory 
required by the task group is to be taken. 


-WD RBT DIR 


-LRN 2 


The working directory to be used by the task group. 
The directory used should have a START_UP.EC file 
containing the ready on (RDN) command. This com- 
mand causes the system to isSue a ready message 
when the task group has been created. 


Two logical resource numbers (LRN) are needed by RBT. 
This number should increase if there are any other 
requirements for this task group. 


MAKING INITIAL DEVICE ASSIGNMENTS 


Once the task group has been created, the input and output 
files are assigned to devices by using the ASSOCIATE command. - 


The format for the command is: 


ASSOC 1lfn path name (C/R) 


lfn is: 
1 - input file 
2 - print file 
3 - punch file 


The following is an example of the typeins: 


ASSOC 2 !LPTOO 
ASSOC 3 !MT900>vol>file 


( ASSOC 1 !CDROO 


F=5 
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The first line assigns the input file to card reader CDROO. 
second line assigns the print file to line printer LPTOO. 


The 
The 


third line assigns the punch file to magnetic tape unit MT900. 
Vol and file must be given names by which they can be accessed. 


MODIFYING EXTERNAL SWITCHES 


The External Switch Word (ESW) should be set, if desired. 


The ESW should first be set 
bits turned on. The format 


to all zeros and then the desired 
for the typein is: 


MSW -ALL OFF -ON nn...n(C/R) 
MSW - Command to modify ESW 
-ALL OFF - Turn off all ESW bits 
-ON - Turn on the following bits 


n- 


The bit (hexadecimal digit) that is 


to be turned on 


The following is a breakdown of the 
bits in the External Switch Word: 


Bit On Off 
0 LIST NOLIST 
1 PUNCH NOPUNCH 
2 AUTOCALL NOAUTOCALL 
3 Reserved for system use 
4 STATS NOSTATS 
5 ASCII (READ) GBCD 
6 Reserved for system use 
8 LFN 3 out ASCII LFN 3 out VBT 
9 
A 
B 
C Reserved for system use 
D 
E 
F 


Default values can be used for ESW settings; bits 0 and 1 
will be set for LIST and PUNCH. The relationship between ESW 
settings and remote batch disposition codes is explained in the 


Remote Batch Facility User's Guide. 
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INVOKING THE RBT TASK GROUP 


To invoke the RBT task group and associate it with a logical 


Stream, enter the following command: 


RBF lrn(C/R) (Cartridge disk environment) 
or 

“ZSYS11 RBF lrn(C/R) (Diskette environment) 
or 


RBT device name 


The lrn value or device name is taken from the configuration 
directive in the CLM_USER file. It specifies the logical stream 
you wish to uSe. 


The system responds with: 


(tg) hhmm RBF xnnn mm/dd/hhmm AA/BB/CC/DDDD 
(tg) hhmm RBF RDY 
(tg) hhmm RBF STATION NAME = 9999 


tg - Task group id 
hhmm —- Hours, minutes 
X - S for SAF mode, L for LAF mode 
nnn - Software revision number 
AA/BB/CC/DDDD —- Date/Time identification of RBF 
9999 - NPS Station Name for LHDLC only. 


The system is now ready to accept commands. 


Initializing with a Command File 


An alternate method of performing initialization is to build 


a command file with the system Editor and use the EC command for 
execution. The following steps are necessary: 


1. Refer to the System Messages manual for a description of 
the execution command (EC) and the EC command arguments, 


and to the Program Preparation manual for instructions 
on the use of the Editor. 


An example of a command file to spawn a task group is: 
S$ SP_GRP.EC 1980/06/08 
&N 


SG Al RBT.USER.OPR 2 !CONSOLE -OUT !CONSOLE 
-WD RBF DIR -POOL AB 
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&Q 
To execute this command, you must be operating in the 
system task group (&S) and type in: 
EC SP_GRP(C/R) 
The system responds with: 


(SS)SG Al RBT.USER.OPR ... 
($S)RDY: 


You can now either remain in the system default task 
group or change to a new task group by typing: 


C SALe(C7R) 

Again, it is advisable to turn ready on by typing: 

RDN (C/R) 
The task group responds with: 

(Al) RDY: 
The second command file, as stated above, performs the 
ASSOC and MSW commands and invokes the RBT. An example 
of this command file is: 
& RBT.EC 1980/06/08 
& N 
ASSOC 1 !CDROO 
ASSOC 2 !LPTOO 
ASSOC 3. PUNCH FILE 


MSW -ALL OFF -ON O1 (Optional; defines default state) 


RBT 03 (Cartridge disk; specify “ZSYS11 RBT 03 for 
diskette) 


&Q 
The typein for this file is: 
EC RBT(C/R) 


The system responds by printing out the commands in the 


command file, and: 
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(tg) hhmm RBT xnnn mm/dd/hhmm 
(tg) hhmm RBT RDY: 


You are now ready to perform remote batch procesSing. 
3. If the system is to have multiple terminals, individual 

command files can be generated for the task groups and 

they can be: grouped into a single command file. 

Example: 

& SP GRPS.EC 

EC SP GRP1l 


EC SP _GRP2 
EC SP _GRP3 


By typing in: 
EC SP_GRPS(C/R) 
you can Spawn three task groups with a single command, 


or, if desired, you can Spawn the task groups 
individually. 
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APPENDIX G 


FILE TRANSMISSION 


This appendix describes the Level 6 configuration particu- 
lars that relate to file transmission in conjunction with the 
configuration information already presented in this manual. In 
this appendix, "TRAN" is a general term used to denote the 
various Level 6 file transmission utility designations (TRAN * 
and TRANB). 


LINE PROTOCOL CONFIGURATION 


The VIP 7700 line protocol is utilized in file transmission 
between the Level 6 and Honeywell host systems. Through the use 
of the PVE (polled VIP Emulator) line protocol handler, the 
Level 6 appears to the host system as a VIP 7700 terminal. The 
PVE is configured uSing the PVE directive as described in 
Section 6 of this manual. 


The following argument specifications of the PVE directive 
must be noted in configuring a Level 6 for file transmission: 


e The poll address specified in the directive must match 
that configured in the host system for the desired 
communications line. 


e High-speed lines should be configured at the highest 
priority levels (lowest numeric); i.e., line speeds of 
2400 and 9600 baud could be configured at priority 
levels of 20 and 10, respectively, but not 10 and 20. 

The maximum line speed supported in the”’file transmission 
facility is 9600 baud. 


e The disk device containing the files to be transmitted 


or received must be configured at a lower priority level 
(higher numeric) than the communications device. 
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eo The lrn selected for the directive is the argument used 
in the TRAN invocation for file transmission (see the 
appropriate File Transmission manual). If a DEVICE 
directive is coupled with a PVE directive, a filename may 
be used in the TRAN invocation as an alternative to a 
numeric Ilrn. 


In a Level 6 to Level 6 file transmission configuration, the 
Level 6 designated as the host system (acceptor) is configured 
with a VIP (see Section 6) for the communications line, while the 
Level 6 acting as the remote station (initiator) is configured 
with a PVE for the same line. Again, the poll addresses must 
match. 


NOTE: If nonswitched lines are used in Level 6 to Level 6 
file transmission, the system configured with a PVE 
must have TRAN invoked first. This will insure that 
polls sent from the host system will be answered. 


Level 6/BSC 2780 File Transmission 


The Level 6 configures BSC protocol on the desired communi- 
cations line for file transmission with an IBM system. The BSC 
directive must specify EBCDIC (see Section 6, "BSC Directive"). 
The same argument specifications listed above apply. 


MEMORY SIZE 


The memory requirements of the TRAN program, as detailed in 
the appropriate File Transmission manual, must be included to 
calculate the size of the system pool area as described in this 


manual. This is done to meet the requirement of Shareable bound 
units. 


The memory pool associated with the task group(s) in which 
TRAN will be initiated must meet the size requirements of task 
group control, lead task control block, ECL task, plus the 
additional work spaces as detailed in the appropriate File 
Transmission manual. 


NOTE: A task group must be created for each concurrent 
execution of TRAN. The available memory for each 


group must, again, meet the size requirements as 
stated above. 
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APPENDIX H 


2780/3780 WORKSTATION FACILITY CONFIGURATION 


For the 2780/3780 Workstation Facility (WF) to interface 
effectively with the host system, the following Level 6 config- 
uration environment must be established: 


e Noncommunication directives to define the following 
noncommunications aspects of the system software: 


- System variables 
- Characteristics and sizes of memory pools 


- Physical and logical characteristics of peripheral 
devices used by the 2780/3780 WF. 


- System overlays 
- System software extensions 


® Two communications directives used to define the 
following: 


- The priority level at which the MLCP (Multiline 
Communications Procesor) interrupts the central 
processor (COMM communications directive) 


- The binary synchronous line protocol handler (BSC 
communications directive)! 


- Use (or non-use) of multi-record feature 


Usage of both communications and noncommunications directives are 
described in detail in this manual. 


Figure H-l shows a typical Level 6 configuration required 
to execute the 2780 WF. 


1For 2780 WF, the multi-block-count must be either 2 or 7 to 


match the host configuration. 
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(SH)DEVICE KSROO,0,5,X'0500' ,CONSOLE,140 

(SH)SYS ,,,10,40,40,,E 

(SH)DEVICE RCDO1,4,9,X'1480' Noncommunications 
(SH)DEVICE LPT00,5,18,X'1380',LPTOO 

(#H)DEVICE CDROO,6,19,X'1300!',CRDOO 

(SH)DEVICE DSKO0,7,12,X'400' Directives 
(SH)DEVICE DSKO1,8,13,X'480' 

(SH)DEVICE DSK02,9,14,X'1200' 

(SH)DEVICE DSKO03,10,15,X'1280' 


(SH) COMM 20 
(SH)BSC 22,22,X'FCO0',2,P,EB,7 Communications Directives 


(SH)MEMPOOL S,,10000 

(SH)MEMPOOL ,AB,* Noncommunications Directives 
(SH) * 

(SH) QUIT 


Figure H-l. Typical Level 6 Configuration to Execute the 
2780 WF 
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APPENDIX J 


HASP WORKSTATION FACILITY CONFIGURATION 


For the HASP Workstation Facility (WF) to effectively 
interface with the host system, the following Level 6 environ- 
ment must be established: 


e Noncommunications directives to define the following 
noncommunications aspects of the system software: 


- System variables 
- Characteristics and sizes of memory pools 


- Physical and logical characteristics of peripheral 
devices used by the HASP WF 


- System software extensions 


e Two communications directives used to define the 
following: 


- The priority level at which the MLCP (Multiline 
Communications Processor) interrupts the central 
processor (COMM communications directive). 


- The HASP line protocol handler (HASP communications 
directive) 


Figure J-1 shows a typical Level 6 configuration required to 
execute the HASP WF. In this example, the Host.Link parameter 


(-N) could be any one of the following: -N 33, -N !HASP1, or -N 
>SPD>HASP1. 
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oYS 


DEVICE 
DEVICE 


DEVICE 
DEVICE 
DEVICE 


DEVICE 
DEVICE 
DEVICE 


DEVICE 
DEVICE 
DEVICE 


DEVICE 


DEVICE 
DEVICE 


DEVICE 


COMM 25 


re7i0,20,20,,E 
KSR00,0,5,X'0500' ,CONSOLE,140 


RCDO1,4,9,X'1480' 


RCD02,5,10,X'1500' 
RCDO3,6,11,X'1580' 
FCD01,8,9,X'1480' 


FCD02,9,10,X'1500' 
FCD03,10,11,X'1580' 
KSRO1,11,12,X'0580' 


DSKO0,12,13,X'0400' 
DSKO1,13,14,X'0480' 
DSKO2,14,15,X'1200' 


DSK03,15,16,X'1280' 
MT900,16,17,X'1600' 


7TTYOL 


LPTOO,17,18,X'1300',LPTOO 


CDROO,18,19,X'1300' 


HASP 33,34,X'FCOO' 


DEVICE 


MEMPOOL 5,, 


MEMPOOL 


QUIT 


Figure J-l. 


HASP, 
10000 


,AB,* 


, DCROO 


33,34,X'FCO00',HASP1 


Typical Level 6 Configuration 
the HASP WF 


Noncommunications 
Directives 


Communications 


Directives 


Noncommunications 
Directives 


to Execute 
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APPENDIX K 


PROGRAMMABLE FACILITY/3271 


NOTE: See the 3270 Interactive Facility User's Guide 
for Programmable Facility/3271 (PF/3271) 
operating instructions. 


After an initial system startup, invoke the Editor to 
build: (1) a CLM_USER file used in configuration of the system 
software that supports the PF/3271 and (2) a login terminals file 
used to describe the characteristics of each VIP 7200 terminal 
used in the dynamic login of VIP 7200 terminals. A Honeywell- 
Supplied generation program (ZF32IN) must then be invoked to 
build an initialization file. If COBOL programming extensions 
are used in conjunction with PF/3271, the COBOL program must be 
linked to a special interface routine (ZCOBIF). The details of 
the initialization file, CLM USER file, login terminals file, and 
COBOL interface are described in this Appendix. 


CLM_USER FILE 


The CLM USER file is used to configure GCOS to support the 
PF/3271. The PF/3271 is composed of the following two bound 
units: (1) one defining the line protocol handler (LPH) for the 
host system and (2) one to define the application portion of the 
PF. The line protocol handler must be loaded at stage 2 system 
Startup (see "Stage 2 System Startup (Intermediate System 
Startup)", Section 3). The directive that defines (loads) the 
line protocol handler for the host system is described in Section 
5 of this manual (See H3270 Directive). 


Configuration information identifying VIP 7200 terminals, on 
lines serviced by the Asynchronous Terminal Driver (ATD), iS sup- 
plied through use of ATD directives (see Section 5 of this man- 
ual). When the system is rebooted, at stage 2 system startup from 
the CLM USER file, a communications line is configured for each 
ATD terminal display plus one communications line for the host 
system. 


CLM_USER FILE EXAMPLE 


The following is a typical example of a CLM USER file 
used in the generation of the PF/3271: 
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CLM USE 
DEVICE 

SYS 60, 
DEVICE 

COMM 7 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

ATDOO 1 
ATDO1 1 
ATDO2 1 
ATDO3 1 
H3270 1 
H3270 1 
MEMPOOL 
MEMPOOL 
MEMPOOL 
MEMPOOL 
MEMPOOL 
MEMPOOL 
MEMPOOL 
QUIT 


In this 


@ Fo 


R FILE 
KSROO,0,5,X'0600' , 'CONSOLE' ,140 
50,,2,20,60,5,E 
LPTO0,30,10,X'0680' 


ATD00,13,9,X'FF80',VIP00,80,N 
ATDO1,14,9,X'FE80' ,VIP01,80,N 
ATD02,15,9,X'FFOO' ,VIP02,80,N 
ATD03,16,9,X'FEO0', VIP03,80,N 
BSC00,12,8,X'FCO00' ,BSCO0 
BSCO1,11,8,X'FC80' ,BSCOl 
3,9,X'FF80',0,9600,'7200' 
4,9,X'FE80',0,9600,'7200' 
5,9,X'FF00',0,9600,'7200' 
6,9,X'FE00',0,9600,'7200' 
2,8,X'FCOO',0,X'40',X'60' 
1,8,X'FC80',2,X'40',X'60' 
S,,17000 

,AB,* 

,AC,* 

Pa 

jaly 

,L2,* 

,L3,* 


example of a CLM USER file, the following is shown: 


ur ATDnn directives have been used causing four 


communications lines to be configured, one per VIP 


72 


@ A 


00 terminal. 


DEVICE directive has been "provided" with each 


ATDOO directive so that each pair contains the 
same lrn, level, and channel number. 


NOTE: See “DEVICE Directive," in Section 5 of this 


manual. 


® Two H3270 directives have been used indicating that 
the line protocol handler (lph) will be loaded once 


de 


@ A 
di 


WA 


fining two host system links. 


DEVICE directive has been "paired" with each H3270 
rective so that each pair contains the same Irn, 


level, and channel number. 


NOTE: See "DEVICE Directive," Section 5 of this manual. 


LOGIN TERMI 


The log 


NALS FILE 


in terminals file is used to describe the character- 


istics of each VIP 7200 terminal to be monitored by the listener 
(a system software component) for access requests issued by the 
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PF/3271. The file is created with the Editor and consists of: 
ae (1) variable-length G-, T- and A-type records and, optionally, 
( (2) a LOGIN command. 


The following is an example of building a login terminals 


File. 
Example: 
Building the login terminals file (after initial system 
Startup). 
Entries Comments 


Editor Commands And 
Directives: 


ED Command to load the Editor 


A Append directive used to enter 
login records (comprising the 
terminals file) into the current 


buffer 
Login Record Entries: 
Gl 3 G-, T- and A-type records comprise 
T VIPOO this example of the login terminals 
AA file to be named "TERMI". In this 
A B example, only VIPOO will have access 
AC to host system links BSCOl, BSCO2 and 


BSC03. The host system links will be 
established through issuance of three 
Separate login commands from the 
operator's console. 


Editor Commands And 
Directives: 


IF Editor escape character 


P Print directive used to display 
contents of the current buffer. 


W TERM1 Write directive used to write 
contents of the current buffer to 
the login terminals file named 
TERMI. 


QUIT Causes the Editor to cease reading 
commands and directives. 


The following example shows three possible login terminal 
( files incorporating login commands. 
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Example: 


is 


Building the login terminals file 


startup). 


Di 


Entries 


Editor Commands And 


rectives: 


ED 


A 


Login Record Entries: 


pHa 


Pa 


Hinder 


21 


VIPOO L HOST] AA 


-ARG !BSCO1 Cl 


2 3 

VIPOO 

A L HOST] AA 
“ARG !BSCO1 Cl 
B L HOST2 AB 
-ARG !BSC02 C2 
C L HOST3 AC 
-ARG !BSC03 C3 


2 4 

A L HOST1 AA 
-ARG !BSCO1l Cl 
B L HOST2 AB 
-ARG !BSC02 C2 
C L HOST3 AC 
-ARG !BSC03 C3 
VIPOO 

VIPOL 


9 
VIPOQG2 


VIPO3 


(after initial system 


Comments 


Command to load the Editor 


Append directive used to enter 
login records (comprising the 
terminals file) into the current 
buffer 


Possibility #1 
G- and T-type record entries comprise 


this example of a login terminals 
file. In this example, only VIPOO 
has access to host link BSCOl. 


Possibility #2 

G-, T- and A-type records comprise 

this example of a login terminals 

file. In this example, only VIPOO 

has access to host links BSCOl, BSCO2, 

and BSC03 because the T-record pre- 

cedes the A-records. 

Note: If multiple T-records precede 
the A-records, only the last 
entered T-record is recognized. 


Possibility #3 
G-, A- and T-type records comprise 


this example of a login terminals 
file. In this example, all VIPs 
have access to host links BSCOl1, 
BSCO2 and BSCO03 because the T- 
records follow the A-records. 
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Editor Commands And 


( Directives: 

IF Editor escape character 

P Print directive used to display 
contents of the current buffer. 

W TERM1 Write directive is used to write 
the contents of the current buffer 
(for one of the previous three 
possibilities) to a login terminals 
file named TERM1. 

OUIT QUIT directive causes the Editor to 


cease reading directives. 


INITIALIZATION FILE 


The initialization file is used to define the site-specific 
information used to interface with the PF/3271. A Honeywell- 


supplied generation program, ZF32IN, is provided to perform the 
following: 


® Create the initialization file 
® Update an existing initialization file 
® List (partially or totally) an existing initialization 


file on,the operator's console 


The generation program operates in an interactive mode consist- 
ing of alternating questions and responses between the gener- 
ation program and you. Depending on the site-specific informa- 
tion to be included in the initialization file, two levels of 
functionality are provided by the generation program. 


Level 1 Functionality 


At this level, the generation program allows the following 
initialization file/record manipulation: 


@ Inclusion of records defining host system linkages 
(through use of the HOST directive, described later 
in this appendix). 


® Deletion of existing host system records and affiliated 
device asSignment records (through use of the DELETE 
directive, described later in this appendix). 


® Positioning of the initialization file to either receive 
new device assignment records or update existing device 
( assignment records affiliated with host system records 
(through use of the POSITION directive, described 
later in this appendix). 
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@ Listing, on the operator's console, of all information 
pertaining to either: (1) all records defining host 
System linkages or (2) a specific record defining 
a host system linkage (in both cases, through use 
of the CURRENT directive, described later in this 


appendix). 


@ Specification of the number of Screen Image Buffers 
(through the BUFFERS directive, described later in this 


appendix). 


Directives, which interface with the generation program 
in the interactive mode, are used to implement the previously 
described initialization file/record manipulation. Table 
K-1 shows the Level 1 directives which are used to define host 


system linkages. 


Level 2 Functionality 


At this level, the generation program allows the following 
initialization file/record manipulation: 


® Definition of device (address) assignment records 
(through use of the PRINTER, VIRTUAL and SCREEN 


directives). 


@ Updating or deletion of device (address) assignment 
records (through use of the Y, N and D directives). 


Directives, which interface with the generation program 
in the interactive mode, are used to implement the previously 
described initialization file/record manipulation. Table 
K-2 shows the Level 2 directives which are used to define 
or update device (address) assignment records. Depending 
on the desired application, both Level 1 and Level 2 directives 
can be used together. 


In the format descriptions shown in the tables which 
follow, brackets ([{ ]) enclose optional arguments and 
braces ({ }) indicate a choice. 
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Table K-1. Level 1 Directives 


Generation Program Level 1 Directives/Responses 
Prompts 


ENTER CURRENT FILENAME 


Enter name of new initialization 
file to be created or existing 

file previously created by present 
generation program. 


name consists of from 1 to 12 alpha- 
numeric characters; the first char- 
acter must be alphabetic or a dollar 
Sign (S$). 


ENTER CURRENT OR HOST 
WITH PATHNAME, BUFFER 
OR QUIT 


HOST pathname [block size] 
CURRENT [pathname] 

BUFFERS nn 

QUIT 


HOST 
If a new pathname is specified, 
entry of this directive creates 
a new host system record in the 

initialization file which defines 

the host system linkage. 


pathname consists of !xXxxx, 

where XXxx represents a commun- 
ications device unit (see "DEVICE 
Directive," Section 5 of this 
manual). 


blocksize (nnnn) uses a default 
value of 2000 if not otherwise 
Specified. 


If the host system record already 
exists, you can poSition, delete 
or update host system records or 
device (address) assignment 

records (see POSITION and DELETE 
directives, latew in this table). 


If you decide to position records, 
you can then choose to update 
device (address) assignment rec- 
ords (see PRINTER, VIRTUAL and 
SCREEN directives, Table K-2, 
later in this appendix). 
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Table K-l (cont). 


Level 1 Directives 


Generation Program Level 1 Directives/Responses 
Prompts 


CURRENT [pathname] 


If pathname is specified, all 
information pertaining to a 
specific record (defined through 
a HOST directive) identifying a 
host system linkage is listed. 


If no pathname is specified, all 
information pertaining to all 
records (defined through. several 
HOST directives) identifying sev- 
eral host system linkages is 
listed. 


pathname consists of !xxxx, 

where xXXxx represents a communica- 
tions device unit (see "DEVICE 
Directive," Section 5 of this 
manual). 


BUFFERS nn 


Entry indicates the number of 
Screen Image Buffers (SIBs). 


nn consists of values from 1 to 
99. If the number of SIBs have 
been previously specified, entry 
of nn overlays any previous 
number. 


NOTE: ‘'COPY' minimally requires 
two buffers. The number 
of buffers should equal 
one-half the number of 
screens. 
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Table K-l (cont). Level 1 Directives 


Generation Program 
Prompts 


Level 1 Directives/Responses 


NOTE: The prompt ENTER CURRENT OR 
HOST WITH PATHNAME, BUFFER 
OR QUIT again appears 
following the BUFFERS 
entry. 


QUIT 


Entry indicates the initialization 
file will be closed and generation 
program ZF32IN will be exited. 


DO YOU WISH TO POSITION lalla 
OR DELETE? DELETE 


POSITION 


Entry positions the initialization 
file to receive new device 
(address) assignment records or to 
update existing device (address) 
asSignment records. Once the file 
1S poSitioned, entry or updating 
of device assignment records can 
occur following the prompt: 

ENTER COMMAND OR QUIT (See 

Table K-2 for details). 


DELETE 


Entry deletes a specified (via 
HOST directive) host system record 
and any device (address) assign- 
ment records affiliated with it. 
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Table K-2. Level 2 Directives 


ENTER COMMAND OR PRINTER dn pathname 
QUIT ‘ VIRTUAL dn pathname 
SCREEN dn [pathname] [1920] 


PRINTER dn pathname 


Entry indicates a printer device 
(address) asSignment. 


dn consists of a valid device 
address selected from Table K-4, 
later in this appendix. 


If the device (address) assignment 
record (affiliated with the par- 
ticular host system record) has 

not been previously defined, a new 
device (address) assignment record 
will be created. However, if the 
device (address) asSignment record 
has been previously created, you 
must either update or delete the | 
device (address) assignment record. 


NOTE: Update and delete functions 
are described later in this 
table. 


pathname consists of !xXxxx, 
where xxxx represents a standard 
device unit (see "DEVICE 
Directive," Table 4-2 in this 
manual). ; 


VIRTUAL dn pathname 


Bntry indicates an application pro- 
gram device (address) assignment. 
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Generation Program Level 2 Directives/Responses Se 
Prompts _ 


J 


Table K-2 (cont). Level 2 Directives 


( : Generation Program Level 2 Directives/Responses 
‘ Prompts 


dn consists of a valid device 
address selected from Table K-4, 
later in this appendix. If the 
device (address) assignment record 
(affiliated with the particular 
host system record) has not been 
previously defined, a new device 
(address) assignment record will be 
created. However, if the device 
(address) assignment record has 
been previously created, you must 
either update or delete the device 
(address) assignment record. 


NOTE: Update and delete functions 
are described later in this 
table. 


pathname consists of the pathname 
of the application program access- 
ing the virtual device. For a 
description of pathnames, see the 


appropriate Operator's Guide. 
SCREEN dn [pathname] [1920] 


Entry indicates a VIP 7200 terminal 
display unit. 


dn consists of a valid device 
address selected from Table K-4, 
later in this appendix. If the 
device (address) assignment record 
(affiliated with thé particular 
host system record) has not been 
previously defined, a new device 
(address) assignmé@nt record will be 
created. However, if the device 
(address) asSignment record has 
been previously created, you must 
either update or delete the device 
(address) assignment record. 


NOTE: Update and delete functions 


are described later in this 
table. 
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Table K-2 (cont). Level 2 Directives 


Generation Program Level 2 Directives/Responses | | 
Prompts 


Optional; pathname is the pathname 
of the user's application program. 


NOTE: Level 1 directives HOST, 
CURRENT or BUFFERS can be 
entered following the prompt: 
ENTER COMMAND OR QUIT. How- 
ever, the effect will be to 
terminate any other entries, 
update any device (address) 
asSignment records and return 
to Level 1 processing (see 
Table K-l, earlier in this 
appendix). 


UPDATE OR DELETE EXIST- Y [ES] 


ING DEVICE ADDRESS? 
(YES, NO, DELETE) Entry indicates device (address) 


asSignment record will be updated 
with information previously entered 
through a device (address) assign- 
ment record. 


N[O] 
Entry indicates device (address) 
assignment record will not be 
deleted. 

D(ELETE] 
Entry indicates device (address) 
asSignment record will be deleted 


(in effect, disassociated from the 
Current host system record). 
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Error Messages 


( | The following error messages, shown in Table K~3, are 
produced by the generation program. 


Table K-3. Error Messages 


Error Messages Description 


ILLEGAL PATHNAME The pathname used on a CURRENT direc- 
tive could not be located. The follow- 
ing generation program prompt is 
repeated: ENTER CURRENT OR HOST WITH 
PATHNAME, BUFFER OR QUIT. 


PATHNAME MISSING Either: | 

(1) A HOST directive without a 
pathname was entered. The 
following generation program 
prompt is repeated: ENTER 
CURRENT OR HOST WITH 
PATHNAME, BUFFER OR QUIT. 

Or: 

(2) A PRINTER or VIRTUAL direc- 
tive without a pathname was 
entered. The following 
generation program prompt 
is repeated: ENTER COMMAND 


OR QUIT. 
INVALID DEVICE: PRINTER, VIRTUAL or SCREEN directive 
COMMAND IGNORED does not have proper device (address) 


assignment (see Table K-4 for proper 
device addresses). The following 
generation program prompt is repeated: 
ENTER COMMAND OR QUIT. 


INVALID PARAM For the BUFFER directive, nn exceeds 
two digits. The following generation 
program prompt is repeated: ENTER 
CURRENT OR HOST WITH PATHNAME, BUFFER 
OR QUIT. 


For the HOST directive, nnnn (block- 
Size) exceeds four digits. The follow- 
ing generation program prompt 1s 
repeated: ENTER CURRENT OR HOST WITH 
PATHNAME, BUFFER OR QUIT. 
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Table K-3 (cont). Error Messages 


Error Messages Description 


NO HOSTS CREATED Before any host system records were 
created, a CURRENT directive was 
specified without, in this case, a 
required pathname. The following 
generation program prompt is repeated: 
ENTER CURRENT OR HOST WITH PATHNAME, 
BUFFER OR QUIT. 


ILLEGAL ENTRY An invalid entry was made in response 


(CURRENT,HOST, to the following generation program 
BUFFERS, QUIT) prompt: ENTER CURRENT OR HOST WITH 
PATHNAME, BUFFER OR QUIT. 


NOTE: The prompt is repeated. 


ILLEGAL ENTRY An invalid entry was made in response 
(SCREEN,VIRTUAL, | to the following generation program 
PRINTER,CURRENT, prompt: ENTER COMMAND OR QUIT. 
HOST,BUFFERS, QUIT) 

NOTE: The prompt is repeated. 


Device Addresses 


The following table shows the valid addresses used with 
the VIRTUAL, SCREEN and PRINTER directives (shown in Table K-2). 


Table K-4. Device Addresses 
Device Or Addresses 


Control Unit 
' Numbers 


OMYIAHANMNHWNE O 


K-14 CB23-03 


Table K-4 (cont). Device Addresses 


Device Or Addresses 
Control Unit 
Numbers 


Examples of Initialization Files 


In Example 1, an initialization file has been created 
containing one host system record and its associated device 
(address) assignment records: 


Example 1 


RDY : 

ZF32IN 

3271 INITIALIZATION PROGRAM 9066 
ENTER CURRENT FILENAME 

TESTEL 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
BUFFERS 06 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
HOST !BSCl 

ENTER COMMAND OR QUIT 

PRINTER Cl !LPTO1 

ENTER COMMAND OR QUIT 

PRINTER C2 !LPTO2 

ENTER COMMAND OR QUIT 

SCREEN Dl, PROGI1 

ENTER COMMAND OR QUIT 

SCREEN,D2, PROGI1 

ENTER COMMAND OR QUIT 

SCREEN,D3, PROGI 

ENTER COMMAND OR QUIT 

VIRTUAL 5A >DONW>PROGI 

ENTER COMMAND OR QUIT 
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Example 1 (cont). 


CURRENT 

CURRENT DEVICE ASSIGNMENTS: 
BUFFER COUNT 06 

NUMBER OF HOSTS Ol 
HOST LINK !BSCl 
BLOCKING 0512 

SCREEN Dl 1920 PROGIL 
SCREEN D2 1920 PROGL 
SCREEN D3 1920 PROGI 
VIRTUAL 5A >DONW>PROG1 
PRINTER Cl !LPTO1L 
PRINTER C2 !LPTO2 


ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
QUIT 


In Example 2, an initialization file has been created 
containing two host system records and their associated 
device (address) assignment records: 


Example 23 


RDY: 

ZF 32IN 

3271 INITIALIZATION PROGRAM 9066 
ENTER CURRENT FILENAME 

TESTF1 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
HOST !BSCl 256 

ENTER COMMAND OR QUIT 

PRINTER Cl !LPTO1] 

ENTER COMMAND OR QUIT 

PRINTER C2 !LPTOL 

ENTER COMMAND OR QUIT 

SCREEN Dl, PROGI 

ENTER COMMAND OR QUIT 

SCREEN D2, PROGI 

ENTER COMMAND OR QUIT 

SCREEN D3, PROGIL 

ENTER COMMAND OR QUIT 

VIRTUAL 5A >DONW>PROGI 

ENTER COMMAND OR QUIT 

BUFFERS O69 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT. 
HOST !BSC2 1024 

ENTER COMMAND OR QUIT 

PRINTER C3 !LPTO3 

ENTER COMMAND OR QUIT 


K-16 CB23-03 


Example 2 (cont). 


PRINTER C4 !LPTO4 
ENTER COMMAND OR QUIT 
SCREEN,D4,!TTYO04 

ENTER COMMAND OR QUIT 
VIRTUAL 5F >DONW>PROG2 
ENTER COMMAND OR QUIT 
CURRENT 


CURRENT DEVICE ASSIGNMENTS: 
BUFFER COUNT 09 
NUMBER OF HOSTS Q2 


HOST LINK !BSCl 
BLOCKING 0256 

SCREEN Dl 1920 PROG1 
SCREEN D2 1920 PROGIL 
SCREEN D3 1920 PROG1 
VIRTUAL 5A >DONW>PROGI 
PRINTER Cl !LPTO1 
PRINTER C2 !LPTO2 


HOST LINK !BSC2 
BLOCKING 1024 

SCREEN D4 1920 PROGI 
VIRTUAL 5F >DONW>PROG2 
PRINTER C3 !LPTO3 
PRINTER C4 !LPTO4 


ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
QUIT 
RDY: 


In Example 3, an initialization file (containing the host 
system records created in Example 2) is positioned to the 
second host system record, and updating and deletion functions 
are performed on existing device (address) assignment records: 
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Example 3 


RDY: 

ZF 32IN 

3271 INITIALIZATION PROGRAM 9066 
ENTER CURRENT FILENAME 


TESTF1 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
HOST !BSC2 

DO YOU WISH TO POSITION OR DELETE? 

POSITION 


ENTER COMMAND OR QUIT 

SCREEN, 5F,!TTY05,1920 

UPDATE OR DELETE EXISTING DEVICE ADDRESS? (YES,NO,DELETE) 
YES 

ENTER COMMAND OR QUIT 

PRINTER C4 !LPTO4 

UPDATE OR DELETE EXISTING DEVICE ADDRESS? (YES,NO,DELETE) 
DELETE 

ENTER COMMAND OR QUIT 

CURRENT 


CURRENT DEVICE ASSIGNMENTS: 
BUFFER COUNT 09 
NUMBER OF HOSTS 02 


HOST LINK !BSCl 
BLOCKING 0256 

SCREEN Dl 1920 PROGI 
SCREEN D2 1920 PROG] 
SCREEN D3 1920 PROGI 
VIRTUAL 5A >DONW>PROGI 
PRINTER Cl !LPTOL 
PRINTER C2 !LPTO2 


HOST LINK !BSC2 
BLOCKING 1024 

SCREEN D4 1920 PROG] 
SCREEN 5F 1920 PROGI 
PRINTER C3 !LPTO3 


ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 


QUIT 
RDY: 
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COBOL Interface Program 


( To run a COBOL program on the PF/3271, the COBOL program 

needs a special interface. The object module of the COBOL 
program must be linked with the Honeywell-Supplied interface 
program (ZCOBIF). The following is an example of creating 
such a bound unit: 


LINKER XXXXXX 
LIB >ZCIRT 
LINKN ZCOBIF, YYYYYY; MAP; QUIT 


where XXXXXX is the bound unit name assigned by the user 
and YYYYYY is the name of the COBOL program object file. 
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APPENDIX L 


LISTENER COMPONENT AND LOGIN CAPABILITY 


INSTALLING A SYSTEM LOGIN CAPABILITY 


The listener component enables access to the system from a 
designated set of terminals. It must run as the lead task of 
task group SL, and can be activated uSing commands in the system 
START UP.EC file or by entering commands from the operator 
terminal after system startup is complete and the system is 
operational. 


When the listener is active, a user can log in to the system 
from the noncommunications terminals (MDC-connected) or commun- 
ications terminals (MLCP/DLCP-connected) listed in a "terminals" 
file. The terminals monitored by listener for a login command 
cannot be directly reserved by system applications. 


To provide a syStem with the login capability, make the 
following preparations: 


l. Create the terminals file which describes the login 
characteristics of each terminal to be used for login. 
This file determines in which one of three ways login 
1s to be achieved. A terminal can (a) require a LOGIN 
command typein, (b) allow a uSer to type an abbreviation 
for the login command line, or (c) be immediately logged 
in, without a typein, when it is ready or connected. 


2. Allocate memory pools for login by use of the CLM 
MEMPOOL directive. 


Once these preparations are completed, you can activate 


the listener as the lead task of task group SL. Listener 
activation is described later in this appendix. 
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MEMORY POOLS FOR LOGIN TASKS 


When you log in aS a primary user at a terminal, a task group 
1S spawned which has that terminal as its user in and uSer out 
files. When you enter a LOGIN command, you may specify the task 
group identification (a two-character group id) or accept a 
default group id. For each task group to be spawned by a LOGIN 
command, you must define a memory pool whose pool id is the same 


as the group id. The first character of a default group id/pool | 


id is an alphabetic character that may be specified by the user 
when the listener is activated. If no character is specified, 
the letter L becomes the first character. The second character 
is the next unused character from the sets 0,...,9 and A,...,Z. 
If only defaults are taken, the number of default pools must at 
least equal the number of users who may concurrently gain access 
to the system. This number is specified in the G-record of the 
terminals file. You can define pools that are completely over- 
lapping by specifying each pool in a Separate MEMPOOL directive. 
(This alSo applies to any other type of memory pool that you wish 
to define.) For example, to make available all of the nonexclu- 
Sive pool area for three users who accept default pool ids, use 
the following directives: 


MEMPOOL ,LO,* 
MEMPOOL ,L1,* 
MEMPOOL ,L2,* 


Additional.examples illustrating the allocation of memory are 
included in the description of the MEMPOOL directive. 


TERMINALS FILE 


Listener determines which terminals to monitor for system 
access from information in a terminals file. The pathname of 
the terminals file may be specified in the command that requests 
the listener task, or may be defaulted to >SID>TERMINALS. The 
file is created with the Editor and consists of variable-length 
G-,T-, and A-type records. Arguments within a record are sep- 
arated by one or more blank characters. For a terminal to have 
the direct login characteristic, the LOGIN command must be 
Specified in the T-record for that terminal. 


For a terminal to have the option of accepting abbrevia- 
tions for LOGIN commands it requires A-records with the desired 
command line image and the absence of a login line in the 
T-record for that terminal. One or more abbreviations can be 
specified. The A-records following a T-record are associated 
only with that terminal. The A-records following the G-records 
allow all terminals to use those abbreviations for command 
lines. When the same abbreviation is used in an A-record fol- 
lowing a G-record, and in an A-record following a T-record, the 
command line image in the A-record following the T-record is 
used for the terminal. The layout of the records of the termi- 
nals file is shown below. 
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oN 


G-Record (only one per file) 

( [A-Records -- one or more for all terminals] 
T-Record -- for a specified terminal 
[A-Records -- one or more for the above terminal] 


T-Record -- for another specified terminal 


[A-Records -- one or more for the above terminal] 


G-Record In Login File 


There is one G-record in the login terminals file, in the 
format: 


G base lvl max user 


base lvl 


Level, relative to the lowest numeric (highest priority) 
level not used by the system group, on which the lead 
task of a group spawned by listener for a terminal is to 
execute unless a level is specified in the login line. 


max user 


Maximum number of concurrent logged-in users allowed 

on the system. This value does not include task groups 
created or spawned by commands other than LOGIN. Logins 
that exceed this limit are terminated and the listener 
issues the message 


3915 NUMBER OF CURRENT USERS EXCEEDS THE MAXIMUM 
T-Record In Login File 


There is one T-record in the terminal login file for each 
terminal on which a user may log in, in the format: 


T [A] dev name [login line] 


Specifies that only abbreviated logins will be allowed at 
this terminal. If a user specifies a nonabbreviated 
login line at this terminal, the listener issues the fol- 
lowing error message: 


3916: LOGIN MUST BE BY ABBREVIATION 
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dev _name 


Symbolic device name of the terminal, as specified at \ 
configuration. 


login line 


The login command line image (including the LOGIN or L 
characters) used instead of a user typein when a terminal 
iS to be used for direct login. 


A-Record In Login File 


An A-record contains an abbreviation character and the assoc- 
iated LOGIN command line image that the listener will use when 
a user types in the abbreviation. A variable number of A-records 
may follow the G-record and/or any T-record. When a user enters 
an abbreviation, listener scans the A-records following the 
T-record for that terminal and if a match is found, uses that 
login line for logging in. If the abbreviation is not found, 
listener scans the A-records following the G-record for a match, 
and if a match is found, uses that login line for logging in. 
If no match is found, the listener issues the message: 


390E ABBREVIATION FOR TERMINAL NOT FOUND 
The format for the A-record 18S: 
A abbrev login line 


abbrev 


A l-character abbreviation that a uSer can optionally 
type in when logging in on this terminal. 


login_line 


The LOGIN command line image associated with the 
abbreviation. | 


LOGIN COMMAND 


The abbreviated description of the LOGIN command that follows 
Shows the type of entries that may be includedyin the A- and 
T-records of the terminais file. For a detailed description of 
the LOGIN command, see the Commands manual. Note that the length 


enh neenaiteamnsatieeaat Se eenadiiiamadinamend 


of the login command line is limited to 110 characters. 


The LOGIN command causes (1) a taSk group asSociated with the 
user's terminal to be spawned, or, (2) the terminal to be 
attached to an existing task group as a secondary terminal. Once 
he has access to the system, the user cannot again invoke login 
unless he first uses the BYE command or the task group is other- 


oN 
aS 
\ 


wise terminated. we 
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FORMAT: 


L login id [destination id] [ctl arg] 
ARGUMENT DESCRIPTION: 
login_id 


Establishes the identity of the user who is attempting to 
gain access to the system. Provides the uSer identification 
for the spawned taSk group. The login id argument consists 
of from one to three fields having the following meanings: 


person 
person.account 
person.account.mode 


person 


Name of person who may access system; can be from 
l1 through 12 characters. (For example, WDSMITH 
could be the value for the person field.) 


account 


Name of an account under which the uSer iS to 
work; can be from 1 through 12 characters. (For 
example, JSINVENTORY could be used as the value 
for the account field.) 


mode 


Provides a further identification of the uSer; 
can be from 1 through 3 characters. (For ex- 


ample, VER could be used as the value for this 
field.) 


[destination id] 


Optional argument that permits the user to log in as a 
secondary user of an existing task group. (A request 

for a secondary user terminal must have been previously 
issued by that task group.) To log in aS a Secondary 
user of a user-created applications program, enter the 
value id, where id is the taSk group id of the task group 
in which the application is running. If this argument is 
specified, no other control arguments may be specified. 


[ctl arg] 


None or any number of the following control arguments can 
be selected: 
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path( )id 


Used to override the default lead task, group id/pool 
id, and relative level specifications for the task 
group Spawned as a result of this login procedure. 


path 


Pathname of the bound unit to be executed as the 
lead task of the spawned task group. If the star 
character (*) is entered the lead task is the 
command processor. 


id 

Group _id/pool id of the spawned task. The group 

id and the pool _id are represented by the same ~ 

2-character value. If this argument is not spec- 

ified, a default id iS assigned as for memory 
pools. 

Default: The group id is a 2-character value 
whose first character was specified 
when the listener component was 
activated and whose second character is 
the next unused character in the 
sequence 0 through 9 and A through Z, 
assigned by the system. 

level 


Base priority level at which the spawned group is 
to execute (relative to the system group level). 
A base level of 0 is the next higher level. The 
sum of the highest system physical level plus l, 
and the base level of the group, and the relative 
level of a task within that group, must not 
exceed 62 (decimal). 


Default: The base priority level is that speci- 
fied in the terminals file, relative to 
the system group level. 

patn 

Used to specify the home directory for the task 

group spawned as a result of the login procedure. 


The home directory iS your initial working direc- 
tory when you log in under an account. 
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path 


Pathname of the initial working directory for 
the spawned task group. You muSt Specify a 
full or relative pathname (not a simple path- 
name). If this argument is omitted, the 
working directory pathname is null. 


~LRN n 


Used to override the default maximum logical 
resource number (LRN) value for the task group 
Spawned as a result of this login procedure. 


n 


Maximum LRN value to be used for the spawned 
task group. (The maximum possible LRN value 
is 252.) If this argument is omitted, the 
maximum LRN value is l. 


-~LFN n 


Used to override the default logical file number 
(LFN) value for the task group spawned as a re- 
Sult of the login procedure. 


n 
Maximum LFN value to be uSed for the spawned 
taSk group. (The maximum possible LFN value 
LS 2558) If this argument 1S omitted, the 
maximum value is 15. 

-HOLD 


set the current connect/disconnect device- : 
Specific word to specify that the terminal is to 
be disconnected without phone hangup. This argu- 
ment allows you to reuse the terminal without 
redialing after logging off the system. (See the 
set terminal‘characteristics (STTY) command or 
directive for information about the connect/ 
disconnect device-specific word.) 


Default: The terminal will be disconnected 
according to the setting of the current 
connect/disconnect device-specific 
word. 


-ARG arg arg... arg 
Used to pass additional arguments to the lead 
task of the task group spawned as a result of 
this login procedure. 
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LISTENER ACTIVATION 

Listener is activated with the CG (create group) and EGR 
(enter group request) operator commands, or with an SG (Spawn 
group) operator command, uSing the arguments shown below.! 
These commands and their arguments are described in the Commands 
manual. 
CG $L base lvl -EFN LISTENER -POOL id 


‘path | 
EGR SL user 1d -OUT !CONSOLE -ARG ee ° [x] ["message"] 


SG SL user _id base lvl -EFN LISTENER -POOL id 


-OUT !CONSOLE - ARG nn 


"path i] [x] ["message"] 
[eae | 
"Dat " 


Pathname of the terminals file, which lists the 
terminals on which users may log in, and which 
contains the terminal characteristics records. 


The last character in the pathname must be a 


blank and the entire pathname must be enclosed in 


either single or double quotes. An omitted 
(default) pathname must be written as a pair of 
enclosing single or double quotes (' ') or (" "), 
and results in the default pathname 
>SID>TERMINALS. 


[x] 


The first character in the 2-character pool id 
and group id when default values are used. The 
second character, from 0 through 9 or A through 
Z, iS appended when a task group 1S spawned aS a 
result of the LOGIN command. When this argument 
is omitted, its default value is L. 


When a user specifies a group _id*™ in a LOGIN com- 
mand or in @ login iine for a T-record or A- 
record, listener uses that as a group id instead 
of generating a group id. 


10nce activated, listener can be terminated only if the system 
Shuts down, or by uSing the -QT argument of the SET LISTEN oper- 
ator command. Once terminated, the $L task group can be recre- 
ated as described below. 
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["message"] 


The message-of-the-day, enclosed in quotes to 
provide for embedded blanks, which listener 
transmits to all terminals for display. 


Terminal State After Listener is Activated 


When first activated and again when the sesSSion terminates, 
listener performs specific operations affecting the state of a 
terminal. The output on the terminal that a user sees and the 
State of the terminal depend on whether it is a noncommunications 
Or a communications terminal. 


NONCOMMUNICATIONS TERMINAL STATE WITH LISTENER 


If a terminal is not ready when listener is activated, no 
initial output messages from liStener are displayed when the ter- 
minal comes on line. 


When listener is activated: 


1. If there are terminals online, ready for direct login, 
they display the message-of-the-day. A task group is 
Spawned for each such terminal if the login line image 
contained in that terminal's T-record in the terminal 
login file specifies primary login. The lead task 
defined in the login line is executed. The application 
Should display a prompter message to the terminal indi- 
cating that it is ready to accept input. When the lead 
task terminates, the message-of-the-day is displayed and 
a task group is immediately Spawned again. 


If the login line in the terminal's T-record specifies 
secondary login, the terminal is given to the group named 
in the destination field, provided that the group has an 
outstanding request for a Secondary terminal. The group 
returns the terminal to listener's control by executing a 
release terminal macro call. 


2. Terminals that require a user login, display the message- 
of-the-day and the user login prompter message identify- 
ing the system and giving the date and time: 

LOGIN system id yyyy/mm/dd hhmm:ss.t 
The user can then type in the LOGIN command. When the 


lead task terminates, the message-of-the-day 1s displayed 
followed by the login prompter message. 
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COMMUNICATIONS TERMINAL STATE WITH LISTENER 


Although a communications terminal may not be ready when the 
listener is activated, listener displays a message when the ter- 
minal comes online. Otherwise, when listener is activated, the 
Same operations are done for communications terminals as for non- 
communications terminals described above. 


When a terminal is released: 


1. A terminal connected by phone and with the hangup 
option, is disconnected. The user must dial in again to 
use the terminal. 


2. A terminal connected through a modem bypass or by phone 
without the hangup option, displays the message-of-the- 
day; either the login prompter meSSage is displayed or, 
for a direct login, a login task group iS Spawned. 


CHANGING THE LOGIN MESSAGE OF THE DAY 


RE SRL AER RR a TT OT EE “eR “nal a eR A a a 


After listener is activated, it places an operator response 
request to the operator terminal. The request number must be 
used in the response to listener from the operator terminal that 
changes the message-of-the-day. The message to the listener can- 
not exceed 63 characters and is in the form: 

Amsg noAmessage-of-the-day 
EXAMPLES OF LISTENER OPERATION 


ere eer et er onal 


For these examples, the CLM file includes the following 
directives: 


DEVICE KSRO1,11,21,X'0580',KSRO1 
DEVICE KSR02,12,22,X'0600',KSRO2 
MEMPOOL S,,10000 

MEMPOOL ,LO,* 

MEMPOOL ,L1,* 

MEMPOOL ,M1,* 

MEMPOOL ,AB,* 


Note that memory pools LO, Ll, Ml, and AB all share the same 
Memory. 
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Example 1: 


( The terminals file for this example has the pathname 
“ZSYSSI1>TERMST1 and contains the following records: 
G l 3 
T KSROL 


A XL X.X.X 

A Y L Y.Y.Y -PO * Ml -HD “ZSYS51>SYSLIB2 -LRN 40 -LFN 20 

T KSRO2 

A WL W.W.W 

The listener is activated by command 1 made through the oper- 

ator terminal. Commands 2,3, and 4 illustrate alternative logins 
made through terminal KSRO1l. Note that they cannot be executed 
in sequence unless each is terminated with a BYE command. 


Command 1: 


ASS SG SL A 10 -EFN LISTENER -POOL AB -OUT !CONSOLE 
-ARG '°“ZSYS5S1>TERM>T1A' 


Command 2: 


AX 

Command 3: 

AY 

Command 4: 

AW 

The operations that result from each command are as follows: 


Command 1: Spawns group $L with a user id of A, a relative 
level of 10, bound unit of listener as the lead 
task, uses memory pool AB, the in path and out _ 
path is the console and argument passed to lis- 
tener is the location of the terminals file. The 
character used for default value of the first 
character of pool id and group id was not given 
and this defaults to L. = 
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Command 2: Listener spawns group LO with a user id of X.X.xX, 
lead task of command processor. The command pro- 
cessor issues the message: 170222 (No Working 
Directory) because -HD option was not used. 

User may continue after typing in a CWD command. 


Command 3: Spawns group Ml with a working directory of 
“ZSYSSI>SYSLIB2 and the lead task is the command 
processor. 

Command 4: Because the A record is under the T record for 
KSRO2 and not under the G record or the T record 
for KSRO1, the listener issues the message 

390E ABBREVIATION FOR TERMINAL NOT FOUND 


For a valid login, the W must be typed in on 
KSRO2. 


Example 2: 


The terminals file for this example has the pathname 
“ZSYSSI>TERM>T2 and contains the following records: 


G. -- «2 


A 2Z L Z.Z.Z -PO >SYSLIB2>PR Ml -HD “ZSYS51>SYSLIB2 
-ARG >SID>CLM USER -SP 1 


T KSRO1 

T KSRO2 
The listener is activated by command 1 made through the oper- 
ator terminal. Command 2 is a login made through terminal 
KSRO1. 


Command l1: 


4SSs SG $L B 10 -EFN LISTENER -POOL LO -OUT ! CONSOLE 
-ARG '°ZSYS51>TERM>T2A' 


Command 2: 


AZ 
The operations that result from each command are as follows: 


Command 1: Spawns group $L with a user id of B, a relative 
level of 10, bound unit of listener as the lead 
task; uses memory pool LO; the argument passed to 
listener is the location of the terminals file. 
The first character of pool id and group id was 
not specified and defaults to L. 
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Command 2: Spawns group Ml which prints CLM USER and then 
terminates. 


Example 3: 


The terminals file for this example has the pathname 
“ZSYSS1>TERM>T3 and contains the following records: 


G 1 3 
T KSRO1L LA.A.A 


The listener is activated by the following command which is 
made through the operator terminal. 


ASS SG $L C 10 -EFN LISTENER ~-POOL Ml -OUT !CONSOLE 
-ARG '“ZSYS51>TERM>T3A' M 


This is an example of direct login. The login command is 
specified in the T record. The Spawn group command, typed on the 
operator terminal, spawns listener group $L which uses memory 
pool Ml. Listener then spawns group Ml with the command proces- 
sor as the lead task, Ml as its memory pool, and KSRO1l as uSer in 
and user out. a 


The functionality of this spawn group command can also be 
achieved by the joint uSe of the create group and the enter group 
request commands as shown below. 

CG SL 10 -EFN LISTENER -POOL Ml 
EGR $L C -OUT !CONSOLE -ARG '“ZSYS51>TERM>T3A' M 
A message enclosed in quotation marks may be added to the entries 


following -ARG. This message will appear on the terminal when 
the group is activated. 
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APPENDIX M 


M4 SYSDEF CHECKLIST 


This appendix is included aS a convenience for users of the 
M4 SYSDEF utility. You can use the checklist provided to write 
down information which the utility requires to generate your 
directive file. The information you write down on the checklist 
will be requested by the utility in the same order. 


Note that this checklist does not include all the questions 
which the utility asks. For example, it doesn't list whether VIP 
devices support form feed. Also, the number of spaces provided 
for writing information about peripheral devices isn't meant to 
imply any limits on how many devices of a given type you can 
include in your configuration. 
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1) 


13) 


15) 


4 
op) 
~~? 


M4 SYSDEF CHECKLIST 


ITEM 


Total amount of phySical memory 


Default peripheral channel numbers? 


(If YES, ignore “Channel number" 


entries for noncommunicati 
devices) 


Commercial system (Model 4 
(If NO to #3): Simulator? 
Scientific processor? 

(1E Soces #5): ei guacare 


System identification mess 
(Default: "GCOS 6/MOD400" 


Installation identificatio 


Ons 


IJ II) 2 


age: 


) 


ns 


(Default: "YOUR TOWN, USA") 


Maximum number of concurrent uSers: 


Default SPD names? 

(If YES, ignore "SPD name" 
of subsequent entries) 
Record locking? 


Display Formatting and Con 
Software? 7 


Power fail restart? 


Communications devices? 
(If NO, skip items 15 thro 


Number of communications priority 


levels: 


Number of MLCPs: 


column 


trol 


ugh 21) 


(Options/Units) 
(nnnK) 


(YES/NO) 


(YES/NO) 
(YES/NO) 
(YES/NO) 


(YES/NO) 


(YES/NO) 


(YES/NO) 


(YES/NO) 
(YES/NO) 


(YES/NO) 


(1 through 4) 


(l1 through 10) 
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ea, 


ITEM (Options/Units) 


17) MLCP-connected asynchronous terminals: 


Comm. 
SPD Channel priority Device 
name number level type 


tne NR a —— 
es 


18) VIP 7700's or VIP 7800's to be run in VIP 7700 emulation 


mode: 

Comm. 
Channel priority ROP 
number tevel type 


—meni errr —_—_——— 


19) H3270 Host Links: 


Comm. Polling Select 
SPD Channel priority address address 
name, number level (dec.) (dec.) 
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ITEM (Options/Units) 


20) Polled VIP Emulation Groups: 


Comm. Polling 
SPD Channel StationsS/ priority address 
name number channel level 1 2 3 4 
21) Synchronous Terminals: 
Comm. Control 
SPD Channel VIPS/ priority station? ROP 
name number channel level (YES/NO) type 


22) Binary synchronous communications lines: 


Comm. Primary/ 
Channel priority secondary? 
# number level (P/S) 
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ITEM (Options/Units) 
23) MbDC-connected console (terminal) devices: 


SPD Channel Device 
name number type 


<= CONSOLE 


24) Diskette devices: 


SPD Channel 
name number 


ee eee 


25) Cartridge disk devices: 
Fixed 
SPD Channel platter? 
name number (YES/NO) 


DE aeananemeeenme eed 


26) Cartridge module disk devices: 


SPD Channel 
name number 
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i 28) Card reader devices: 


| 29) Card reader/punch or punch devices: 


* 


27) 


30) 


SPD 
name 


SPD 
name 


oPD 
name 


nT 


SPD 
name 


ITEM 


Storage module devices: 


Channel 
number 


Channel 
number 


Channel 
number 


Line printer devices: 


Channel 
number 


(Options/Units) 
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ITEM 
31) Magnetic tape drives: 


SPD Channel 
name number 


32) Batch memory pool? 


Size of batch pool 


33) Number of 512-word system 
overlay areas (1-99) 


(Options/Units) 


(YES/NO) 
nnonnn or nnk 


words 


(1 to 10) 
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APPENDIX N 


ERROR LOGGING 


Error logging iS an optional feature that allows the system 
operator to collect memory or hardware-related error statistics 
for selected noncommunications peripheral devices. Error logging 
iS intended primarily as a preventive maintenance tool, allowing 
for early detection and correction of potential memory or hard- 
ware failures. ‘he error statistics collected can be used by 
Honeywell field engineering personnel to monitor memory and 
peripheral device performance to determine if corrective actions 
are required. 


As the system builder, you have the option of configuring 
error logging or notl Once configured, the system operator must 
activate error logging through commands or macro calls. Error 
logging commands and operating procedures are described in the 


Commands manual and the Operator's Guide; error logging macro 


calls are described in the System Service Macro Calls manual. 


CONFIGURATION REQUIREMENTS 


Error logging must be incorporated into your configuration 
before memory or device error logging can be activated. The 
following hardware and software requirements are necessary to 
configure error logging for your installation. 


Hardware Requirements 


Error logging requires that you have one or more noncommuni- 
cations devices in your configuration that you wish to monitor. 
(If you wish to log memory errors exclusively, peripheral devices 
need not be attached to the central processor.) In addition, 
cumulative file processing (described elsewhere in this appendix) 
requires that your installation have a CIP (or a CIP Simulator). 


'The interactive building program, M4 SYSDEF, does not allow you 


to configure error logging. You must incorporate the appro- 
priate software module by hand. 
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software Requirements 


To implement error logging, you must load the bound unit \ 
ZERRST, located in directory SID, using an LDBU directive. If 
your working directory is SID, include the following directive in 
your CLM file: 3 


LDBU ZERRST 


Section 5 of this manual describes the LDBU directive in more 
detail. 


MEMORY REQUIREMENTS 


The error logging facility requires a minimum memory area 
equivalent to the sum of the following components: 


@ 2541, words (SAF) or 26315 words (LAF) in the system 
memory pool for the bound unit ZERRST (of which 17i¢ 
words, the initialization section, is overwritten after 
use) 


@ 2216 words (SAF) or 2315 words (LAF) in the system memory 
pool for each device that is monitored 


e 391, words (SAF or LAF) in the system or uSer memory pool 
for data for each error logging command 


e Space for the bound unit to process a particular error 
logging command 


Error logging can be run in the system task group ($S) or in 
a user group (e.g., SH). Since the memory area necessary to run 
the error logging bound unit can be quite large, error logging 
Should not be executed from the $S group. The operator should 
initially create a group large enough to accommodate the error 
logging Session. (If the system operator wishes to create and 
maintain error logging disk files, additional file space is 
required as well.) 


—_ 
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APPENDIX P 


CONFIGURING DISPLAY FORMATTING AND CONTROL SOFTWARE 


This appendix describes the requirements for configuring the 
Display Formatting and Control software. Unless you configure 
this software for your installation, forms processing will not be 
available to users. If your installation uses the Data Entry 
Facility-II (DEF-II), you must configure Display Formatting and 
Control software. Users should have available for reference the 


Display Formatting and Control manual. 
CONFIGURATION REQUIREMENTS 


The following hardware and software requirements are neces- 
Sary to configure the Display Formatting and Control Software. 


Hardware Requirements 


To perform forms proceSSing, your installation requires one 
or more of the following asynchronous terminals connected to an 
MDC or an MLCP/DLCP: VIP 7200, VIP 7205, VIP 7207, VIP 7801, or 
VIP 7802, and a full-duplex modem Such as type 103. 


software Requirements 


To configure forms procesSSing, you must answer ‘yes' when the 
M4 SYSDEF program asks you if you wish to configure the Display 
Formatting and Control software for your installation, or you 
must include the appropriate directives in your CLM file as 
described below. 


CONFIGURATION DIRECTIVES 


The CLM directives required to configure the Display 
Formatting and Control Software depend on whether you wish to 
configure your terminals aS noncommunications (MDC-connected) 
terminals or communications (MLCP-connected) terminals. The 
directives mentioned below are fully described in Sections 5 
and 6. 
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Configuring Noncommunications Terminals for Forms Processing 


The CLM directives required to configure the Display ee, 
Formatting and Control software with noncommunications (MDC- 
connected) asynchronous terminals are as follows: 


VDAM 


This directive must be specified if the Display 
Formatting and Control software is to be incorporated in 
the configuration. (See Section 6 for a full description 
of this directive.) 


DEVICE CONnn,lrn,level,X'channel',[device name], 
[record size],|]jfB\],f'7200' Pa 
N 'D7200'! - 


For each asynchronous terminal capable of running Display 
Formatting Software, you must specify a DEVICE directive 
with the first parameter as CONnn. The eighth parameter 
must be specified as either '7200' (for VIP 7200 or 

VIP 7205 support) or 'D7200' (for VIP 7207 Support.) The 
ninth parameter must be specified as either C (for CRT 
visual display mode) or T (for teleprinter mode). The 
terminal runs in the mode you specify whenever it is not 
running in forms mode (i.e., running the forms processing 
software). Forms mode overrides visual display mode or 
teleprinter mode. 


Configuring Communications Terminals for Forms Processing 


The CLM directives required to configure the Display 
Formatting and Control software with communications (MLCP- 
connected) asynchronous terminals are as follows: 


VDAM 


This directive must be specified if the Display 
Formatting and Control software is to be incorporated in 
the configuration. (See Section 6 for a complete 
description of this directive). 


COMM n 
This directive 1s required for a system that includes 
communications. It must precede all other 
communications-related directives. See Section 6 for a 
description of n, the number of interrupt priority 
levels. 


eo 
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7200 
ATD Irn,level,X'channel', [modem] ,Speed, } 7801 ; 
D7200 


[del] ,[stop-bit][,parity] 


DEVICE ATDnn,lrn,level,X'channel',[device name], 


[record size] Hey 


For each asynchronous terminal capable of running Forms 
Processing Software, you must specify an ATD directive 
and its "paired" DEVICE directive. The sixth parameter 
of the ATD directive must be specified as either 7200 
(for VIP 7200 or VIP 7205 Support), 7801 (for VIP 7801 or 
VIP 7802 Support), or D7200 (for VIP 7207 support). 

VIP 7200 terminals require a full duplex modem (such as 
type 103) to run forms processing. Additionally, the 
data rate (Speed) in bits per second for any asynchronous 
terminal that will run forms processing should be in the 
range of 2400 to 9600. 


CONFIGURATION OPTIONS 


In addition to the configuration requirements described 
above, you have two options to consider when configuring forms 
processing for your installation. You may choose to activate the 
listener capability for terminals in your configuration. You 
also have the option of configuring the operator terminal such 
that you can perform forms processing in a one-terminal 
configuration. 


Listener performs specific operations affecting the State of 
a terminal. Whether you wish to activate the listener or not 
depends entirely on your installation's processing requirements. 


Refer to Appendix L for a complete description of the listener 
capability. 


The terminal configured aS a standard operator terminal in 
your configuration does not support forms processing. If, how- 
ever, the operator terminal has been configured as a dual-purpose 
terminal that runs alternately under operator control and user 
control, users can utilize the forms processing capability when 
the terminal is under uSer control (i.e., not functioning as an 
operator console). In this way it is possible to run forms pro- 
cessing in a one-terminal configuration. Refer to Section 5 for 
information on configuring a dual-purpose operator terminal. 


1Alternatively, you may specify a V7200 directive and its 
"“Daired" DEVICE directive. However, Honeywell recommends using 
the Asynchronous Terminal Device (ATD) driver. 
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